/**
* gdk_app_launch_context_set_icon:
* @context: a `GdkAppLaunchContext`
- * @icon: (allow-none): a #GIcon, or %NULL
+ * @icon: (nullable): a #GIcon, or %NULL
*
* Sets the icon for applications that are launched with this
* context.
/**
* gdk_app_launch_context_set_icon_name:
* @context: a `GdkAppLaunchContext`
- * @icon_name: (allow-none): an icon name, or %NULL
+ * @icon_name: (nullable): an icon name, or %NULL
*
* Sets the icon for applications that are launched with this context.
*
* gdk_clipboard_read_finish:
* @clipboard: a `GdkClipboard`
* @result: a `GAsyncResult`
- * @out_mime_type: (out) (allow-none) (transfer none): pointer to store
+ * @out_mime_type: (out) (optional) (transfer none): pointer to store
* the chosen mime type
* @error: a `GError` location to store the error occurring
*
/**
* gdk_clipboard_set_content:
* @clipboard: a `GdkClipboard`
- * @provider: (transfer none) (allow-none): the new contents of @clipboard
+ * @provider: (transfer none) (nullable): the new contents of @clipboard
* or %NULL to clear the clipboard
*
* Sets a new content provider on @clipboard.
/**
* gdk_content_formats_new:
- * @mime_types: (array length=n_mime_types) (allow-none): Pointer to an
+ * @mime_types: (array length=n_mime_types) (nullable): Pointer to an
* array of mime types
* @n_mime_types: number of entries in @mime_types.
*
/**
* gdk_cursor_new_from_name:
* @name: the name of the cursor
- * @fallback: (allow-none): %NULL or the `GdkCursor` to fall back to when
+ * @fallback: (nullable): %NULL or the `GdkCursor` to fall back to when
* this one cannot be supported
*
* Creates a new cursor by looking up @name in the current cursor
* @texture: the texture providing the pixel data
* @hotspot_x: the horizontal offset of the “hotspot” of the cursor
* @hotspot_y: the vertical offset of the “hotspot” of the cursor
- * @fallback: (allow-none): %NULL or the `GdkCursor` to fall back to when
+ * @fallback: (nullable): %NULL or the `GdkCursor` to fall back to when
* this one cannot be supported
*
* Creates a new cursor from a `GdkTexture`.
/**
* gdk_device_get_surface_at_position:
* @device: pointer `GdkDevice` to query info to
- * @win_x: (out) (allow-none): return location for the X coordinate
+ * @win_x: (out) (optional): return location for the X coordinate
* of the device location relative to the surface origin
- * @win_y: (out) (allow-none): return location for the Y coordinate
+ * @win_y: (out) (optional): return location for the Y coordinate
* of the device location relative to the surface origin
*
* Obtains the surface underneath @device, returning the location of the
* @mime_types: (array zero-terminated=1) (element-type utf8):
* pointer to an array of mime types
* @io_priority: the I/O priority for the read operation
- * @cancellable: (allow-none): optional `GCancellable` object
+ * @cancellable: (nullable): optional `GCancellable` object
* @callback: (scope async): a `GAsyncReadyCallback` to call when
* the request is satisfied
* @user_data: (closure): the data to pass to @callback
* @self: a `GdkDrop`
* @result: a `GAsyncResult`
* @out_mime_type: (out) (type utf8): return location for the used mime type
- * @error: (allow-none): location to store error information on failure, or %NULL
+ * @error: (nullable): location to store error information on failure, or %NULL
*
* Finishes an async drop read operation.
*
* @hardware_keycode: a keycode
* @state: a modifier state
* @group: active keyboard group
- * @keyval: (out) (allow-none): return location for keyval
- * @effective_group: (out) (allow-none): return location for effective group
- * @level: (out) (allow-none): return location for level
- * @consumed_modifiers: (out) (allow-none): return location for modifiers
+ * @keyval: (out) (optional): return location for keyval
+ * @effective_group: (out) (optional): return location for effective group
+ * @level: (out) (optional): return location for level
+ * @consumed_modifiers: (out) (optional): return location for modifiers
* that were used to determine the group or level
*
* Translates the contents of a #GdkEventKey into a keyval, effective
* gdk_rectangle_intersect:
* @src1: a `GdkRectangle`
* @src2: a `GdkRectangle`
- * @dest: (out caller-allocates) (allow-none): return location for the
+ * @dest: (out caller-allocates) (optional): return location for the
* intersection of @src1 and @src2, or %NULL
*
* Calculates the intersection of two rectangles.
/*
* gdk_surface_invalidate_rect:
* @surface: a `GdkSurface`
- * @rect: (allow-none): rectangle to invalidate or %NULL to
+ * @rect: (nullable): rectangle to invalidate or %NULL to
* invalidate the whole surface
*
* Invalidate a rectangular region of @surface.
* gdk_surface_get_device_position:
* @surface: a `GdkSurface`
* @device: pointer `GdkDevice` to query to
- * @x: (out) (allow-none): return locatio for the X coordinate of @device, or %NULL
- * @y: (out) (allow-none): return location for the Y coordinate of @device, or %NULL
- * @mask: (out) (allow-none): return location for the modifier mask, or %NULL
+ * @x: (out) (optional): return locatio for the X coordinate of @device, or %NULL
+ * @y: (out) (optional): return location for the Y coordinate of @device, or %NULL
+ * @mask: (out) (optional): return location for the modifier mask, or %NULL
*
* Obtains the current device position and modifier state.
*
/**
* gdk_surface_set_cursor: (attributes org.gtk.Method.set_property=cursor)
* @surface: a `GdkSurface`
- * @cursor: (allow-none): a `GdkCursor`
+ * @cursor: (nullable): a `GdkCursor`
*
* Sets the default mouse pointer for a `GdkSurface`.
*
/*
* gdk_surface_get_geometry:
* @surface: a `GdkSurface`
- * @x: (out) (allow-none): return location for X coordinate of surface (relative to its parent)
- * @y: (out) (allow-none): return location for Y coordinate of surface (relative to its parent)
- * @width: (out) (allow-none): return location for width of surface
- * @height: (out) (allow-none): return location for height of surface
+ * @x: (out) (optional): return location for X coordinate of surface (relative to its parent)
+ * @y: (out) (optional): return location for Y coordinate of surface (relative to its parent)
+ * @width: (out) (optional): return location for width of surface
+ * @height: (out) (optional): return location for height of surface
*
* Get the geometry of the surface.
*
/**
* gdk_surface_set_opaque_region:
* @surface: a top-level `GdkSurface`
- * @region: (allow-none): a region, or %NULL
+ * @region: (nullable): a region, or %NULL
*
* Marks a region of the `GdkSurface` as opaque.
*
/**
* gdk_win32_display_set_cursor_theme:
* @display: (type GdkWin32Display): a `GdkDisplay`
- * @name: (allow-none): the name of the cursor theme to use, or %NULL
+ * @name: (nullable): the name of the cursor theme to use, or %NULL
* to unset a previously set value
* @size: the cursor size to use, or 0 to keep the previous size
*
*
* Returns the #GdkDevice that wraps the given device ID.
*
- * Returns: (transfer none) (allow-none) (type GdkX11DeviceXI2): The
+ * Returns: (transfer none) (nullable) (type GdkX11DeviceXI2): The
* `GdkDevice` wrapping the device ID,
* or %NULL if the given ID doesn’t currently represent a device.
**/
/**
* gdk_x11_display_open:
- * @display_name: (allow-none): name of the X display.
+ * @display_name: (nullable): name of the X display.
* See the XOpenDisplay() for details.
*
* Tries to open a new display to the X server given by
* gdk_x11_surface_set_utf8_property:
* @surface: (type GdkX11Surface): a #GdkSurface
* @name: Property name, will be interned as an X atom
- * @value: (allow-none): Property value, or %NULL to delete
+ * @value: (nullable): Property value, or %NULL to delete
*
* This function modifies or removes an arbitrary X11 window
* property of type UTF8_STRING. If the given @surface is
* gsk_renderer_render_texture:
* @renderer: a realized `GskRenderer`
* @root: a `GskRenderNode`
- * @viewport: (allow-none): the section to draw or %NULL to use @root's bounds
+ * @viewport: (nullable): the section to draw or %NULL to use @root's bounds
*
* Renders the scene graph, described by a tree of `GskRenderNode` instances,
* to a `GdkTexture`.
* gsk_repeat_node_new:
* @bounds: The bounds of the area to be painted
* @child: The child to repeat
- * @child_bounds: (allow-none): The area of the child to repeat or %NULL to
+ * @child_bounds: (nullable): The area of the child to repeat or %NULL to
* use the child's bounds
*
* Creates a `GskRenderNode` that will repeat the drawing of @child across
/*<private>
* gsk_transform_is_identity:
- * @transform: (allow-none): A transform or %NULL
+ * @transform: (nullable): A transform or %NULL
*
* Checks if the transform is a representation of the identity
* transform.
/**
* gsk_transform_matrix:
- * @next: (allow-none) (transfer full): the next transform
+ * @next: (nullable) (transfer full): the next transform
* @matrix: the matrix to multiply @next with
*
* Multiplies @next with the given @matrix.
/**
* gsk_transform_translate:
- * @next: (allow-none) (transfer full): the next transform
+ * @next: (nullable) (transfer full): the next transform
* @point: the point to translate the transform by
*
* Translates @next in 2-dimensional space by @point.
/**
* gsk_transform_translate_3d:
- * @next: (allow-none) (transfer full): the next transform
+ * @next: (nullable) (transfer full): the next transform
* @point: the point to translate the transform by
*
* Translates @next by @point.
/**
* gsk_transform_rotate:
- * @next: (allow-none) (transfer full): the next transform
+ * @next: (nullable) (transfer full): the next transform
* @angle: the rotation angle, in degrees (clockwise)
*
* Rotates @next @angle degrees in 2D - or in 3D-speak, around the z axis.
/**
* gsk_transform_rotate_3d:
- * @next: (allow-none) (transfer full): the next transform
+ * @next: (nullable) (transfer full): the next transform
* @angle: the rotation angle, in degrees (clockwise)
* @axis: The rotation axis
*
/**
* gsk_transform_scale:
- * @next: (allow-none) (transfer full): the next transform
+ * @next: (nullable) (transfer full): the next transform
* @factor_x: scaling factor on the X axis
* @factor_y: scaling factor on the Y axis
*
/**
* gsk_transform_scale_3d:
- * @next: (allow-none) (transfer full): the next transform
+ * @next: (nullable) (transfer full): the next transform
* @factor_x: scaling factor on the X axis
* @factor_y: scaling factor on the Y axis
* @factor_z: scaling factor on the Z axis
/**
* gsk_transform_perspective:
- * @next: (allow-none) (transfer full): the next transform
+ * @next: (nullable) (transfer full): the next transform
* @depth: distance of the z=0 plane. Lower values give a more
* flattened pyramid and therefore a more pronounced
* perspective effect.
/**
* gsk_transform_ref:
- * @self: (allow-none): a `GskTransform`
+ * @self: (nullable): a `GskTransform`
*
* Acquires a reference on the given `GskTransform`.
*
/**
* gsk_transform_unref:
- * @self: (allow-none): a `GskTransform`
+ * @self: (nullable): a `GskTransform`
*
* Releases a reference on the given `GskTransform`.
*
/**
* gsk_transform_print:
- * @self: (allow-none): a `GskTransform`
+ * @self: (nullable): a `GskTransform`
* @string: The string to print into
*
* Converts @self into a human-readable string representation suitable
/**
* gsk_transform_to_string:
- * @self: (allow-none): a #GskTransform
+ * @self: (nullable): a #GskTransform
*
* Converts a matrix into a string that is suitable for printing.
*
/**
* gsk_transform_to_matrix:
- * @self: (allow-none): a `GskTransform`
+ * @self: (nullable): a `GskTransform`
* @out_matrix: (out caller-allocates): The matrix to set
*
* Computes the actual value of @self and stores it in @out_matrix.
/**
* gsk_transform_transform:
- * @next: (allow-none) (transfer full): Transform to apply @other to
- * @other: (allow-none): Transform to apply
+ * @next: (nullable) (transfer full): Transform to apply @other to
+ * @other: (nullable): Transform to apply
*
* Applies all the operations from @other to @next.
*
/**
* gsk_transform_invert:
- * @self: (allow-none) (transfer full): Transform to invert
+ * @self: (nullable) (transfer full): Transform to invert
*
* Inverts the given transform.
*
/**
* gsk_transform_get_category:
- * @self: (allow-none): A #GskTransform
+ * @self: (nullable): A #GskTransform
*
* Returns the category this transform belongs to.
*
/*
* gtk_css_token_is_preserved:
* @token: a #GtkCssToken
- * @out_closing: (allow-none): Type of the token that closes a block
+ * @out_closing: (nullable): Type of the token that closes a block
* started with this token
*
* A token is considered preserved when it does not start a block.
/**
* gtk_accelerator_parse_with_keycode:
* @accelerator: string representing an accelerator
- * @display: (allow-none): the `GdkDisplay` to look up @accelerator_codes in
- * @accelerator_key: (out) (allow-none): return location for accelerator keyval
- * @accelerator_codes: (out) (array zero-terminated=1) (transfer full) (allow-none):
+ * @display: (nullable): the `GdkDisplay` to look up @accelerator_codes in
+ * @accelerator_key: (out) (optional): return location for accelerator keyval
+ * @accelerator_codes: (out) (array zero-terminated=1) (transfer full) (optional):
* return location for accelerator keycodes
- * @accelerator_mods: (out) (allow-none): return location for accelerator
+ * @accelerator_mods: (out) (optional): return location for accelerator
* modifier mask
*
* Parses a string representing an accelerator.
/**
* gtk_accelerator_parse:
* @accelerator: string representing an accelerator
- * @accelerator_key: (out) (allow-none): return location for accelerator keyval
- * @accelerator_mods: (out) (allow-none): return location for accelerator
+ * @accelerator_key: (out) (optional): return location for accelerator keyval
+ * @accelerator_mods: (out) (optional): return location for accelerator
* modifier mask
*
* Parses a string representing an accelerator.
/**
* gtk_accelerator_name_with_keycode:
- * @display: (allow-none): a `GdkDisplay` or %NULL to use the default display
+ * @display: (nullable): a `GdkDisplay` or %NULL to use the default display
* @accelerator_key: accelerator keyval
* @keycode: accelerator keycode
* @accelerator_mods: accelerator modifier mask
/**
* gtk_accelerator_get_label_with_keycode:
- * @display: (allow-none): a `GdkDisplay` or %NULL to use the default display
+ * @display: (nullable): a `GdkDisplay` or %NULL to use the default display
* @accelerator_key: accelerator keyval
* @keycode: accelerator keycode
* @accelerator_mods: accelerator modifier mask
/**
* gtk_action_bar_set_center_widget:
* @action_bar: a `GtkActionBar`
- * @center_widget: (allow-none): a widget to use for the center
+ * @center_widget: (nullable): a widget to use for the center
*
* Sets the center widget for the `GtkActionBar`.
*/
/*< private >
* gtk_action_muxer_set_parent:
* @muxer: a #GtkActionMuxer
- * @parent: (allow-none): the new parent #GtkActionMuxer
+ * @parent: (nullable): the new parent #GtkActionMuxer
*
* Sets the parent of @muxer to @parent.
*/
/**
* gtk_app_chooser_dialog_new:
- * @parent: (allow-none): a `GtkWindow`, or %NULL
+ * @parent: (nullable): a `GtkWindow`, or %NULL
* @flags: flags for this dialog
* @file: a `GFile`
*
/**
* gtk_app_chooser_dialog_new_for_content_type:
- * @parent: (allow-none): a `GtkWindow`, or %NULL
+ * @parent: (nullable): a `GtkWindow`, or %NULL
* @flags: flags for this dialog
* @content_type: a content type string
*
/**
* gtk_aspect_frame_set_child: (attributes org.gtk.Method.set_property=child)
* @self: a `GtkAspectFrame`
- * @child: (allow-none): the child widget
+ * @child: (nullable): the child widget
*
* Sets the child widget of @self.
*/
/**
* gtk_assistant_set_forward_page_func:
* @assistant: a `GtkAssistant`
- * @page_func: (allow-none): the `GtkAssistant`PageFunc, or %NULL
+ * @page_func: (nullable): the `GtkAssistant`PageFunc, or %NULL
* to use the default one
* @data: user data for @page_func
* @destroy: destroy notifier for @data
/**
* gtk_bitset_ref:
- * @self: (allow-none): a `GtkBitset`
+ * @self: (nullable): a `GtkBitset`
*
* Acquires a reference on the given `GtkBitset`.
*
/**
* gtk_bitset_unref:
- * @self: (allow-none): a `GtkBitset`
+ * @self: (nullable): a `GtkBitset`
*
* Releases a reference on the given `GtkBitset`.
*
/**
* gtk_bookmark_list_new:
- * @filename: (allow-none): The bookmark file to load
- * @attributes: (allow-none): The attributes to query
+ * @filename: (nullable): The bookmark file to load
+ * @attributes: (nullable): The attributes to query
*
* Creates a new `GtkBookmarkList` with the given @attributes.
*
/**
* gtk_bookmark_list_set_attributes: (attributes org.gtk.Method.set_property=attributes)
* @self: a `GtkBookmarkList`
- * @attributes: (allow-none): the attributes to enumerate
+ * @attributes: (nullable): the attributes to enumerate
*
* Sets the @attributes to be enumerated and starts the enumeration.
*
* gtk_buildable_custom_tag_start:
* @buildable: a `GtkBuildable`
* @builder: a `GtkBuilder` used to construct this object
- * @child: (allow-none): child object or %NULL for non-child tags
+ * @child: (nullable): child object or %NULL for non-child tags
* @tagname: name of tag
* @parser: (out): a #GMarkupParser to fill in
* @data: (out): return location for user data that will be passed in
* gtk_buildable_custom_tag_end:
* @buildable: A `GtkBuildable`
* @builder: `GtkBuilder` used to construct this object
- * @child: (allow-none): child object or %NULL for non-child tags
+ * @child: (nullable): child object or %NULL for non-child tags
* @tagname: name of tag
* @data: user data that will be passed in to parser functions
*
* gtk_buildable_custom_finished:
* @buildable: a `GtkBuildable`
* @builder: a `GtkBuilder`
- * @child: (allow-none): child object or %NULL for non-child tags
+ * @child: (nullable): child object or %NULL for non-child tags
* @tagname: the name of the tag
* @data: user data created in custom_tag_start
*
* gtk_builder_add_from_file:
* @builder: a `GtkBuilder`
* @filename: the name of the file to parse
- * @error: (allow-none): return location for an error, or %NULL
+ * @error: (nullable): return location for an error, or %NULL
*
* Parses a file containing a UI definition and merges it with
* the current contents of @builder.
* @builder: a `GtkBuilder`
* @filename: the name of the file to parse
* @object_ids: (array zero-terminated=1) (element-type utf8): nul-terminated array of objects to build
- * @error: (allow-none): return location for an error, or %NULL
+ * @error: (nullable): return location for an error, or %NULL
*
* Parses a file containing a UI definition building only the
* requested objects and merges them with the current contents
* @template_type: the type that the template is for
* @buffer: the string to parse
* @length: the length of @buffer (may be -1 if @buffer is nul-terminated)
- * @error: (allow-none): return location for an error, or %NULL
+ * @error: (nullable): return location for an error, or %NULL
*
* Main private entry point for building composite components
* from template XML.
* gtk_builder_add_from_resource:
* @builder: a `GtkBuilder`
* @resource_path: the path of the resource file to parse
- * @error: (allow-none): return location for an error, or %NULL
+ * @error: (nullable): return location for an error, or %NULL
*
* Parses a resource file containing a UI definition
* and merges it with the current contents of @builder.
* @builder: a `GtkBuilder`
* @resource_path: the path of the resource file to parse
* @object_ids: (array zero-terminated=1) (element-type utf8): nul-terminated array of objects to build
- * @error: (allow-none): return location for an error, or %NULL
+ * @error: (nullable): return location for an error, or %NULL
*
* Parses a resource file containing a UI definition, building
* only the requested objects and merges them with the current
* @builder: a `GtkBuilder`
* @buffer: the string to parse
* @length: the length of @buffer (may be -1 if @buffer is nul-terminated)
- * @error: (allow-none): return location for an error, or %NULL
+ * @error: (nullable): return location for an error, or %NULL
*
* Parses a string containing a UI definition and merges it
* with the current contents of @builder.
* @buffer: the string to parse
* @length: the length of @buffer (may be -1 if @buffer is nul-terminated)
* @object_ids: (array zero-terminated=1) (element-type utf8): nul-terminated array of objects to build
- * @error: (allow-none): return location for an error, or %NULL
+ * @error: (nullable): return location for an error, or %NULL
*
* Parses a string containing a UI definition, building only the
* requested objects and merges them with the current contents of
* @pspec: the `GParamSpec` for the property
* @string: the string representation of the value
* @value: (out): the `GValue` to store the result in
- * @error: (allow-none): return location for an error, or %NULL
+ * @error: (nullable): return location for an error, or %NULL
*
* Demarshals a value from a string.
*
* @type: the `GType` of the value
* @string: the string representation of the value
* @value: (out): the #GValue to store the result in
- * @error: (allow-none): return location for an error, or %NULL
+ * @error: (nullable): return location for an error, or %NULL
*
* Demarshals a value from a string.
*
* @function_name: name of the function to look up
* @flags: closure creation flags
* @object: (nullable): Object to create the closure with
- * @error: (allow-none): return location for an error, or %NULL
+ * @error: (nullable): return location for an error, or %NULL
*
* Creates a closure to invoke the function called @function_name.
*
/**
* gtk_button_set_child: (attributes org.gtk.Method.set_property=child)
* @button: a `GtkButton`
- * @child: (allow-none): the child widget
+ * @child: (nullable): the child widget
*
* Sets the child widget of @button.
*/
* for this row
* @x: the x position
* @y: the y position
- * @alloc_area: (out) (allow-none): where to store the inner allocated area of the
+ * @alloc_area: (out) (optional): where to store the inner allocated area of the
* returned cell renderer, or %NULL.
*
* Gets the #GtkCellRenderer at @x and @y coordinates inside @area and optionally
* @area: a #GtkCellArea
* @context: the #GtkCellAreaContext to perform this request with
* @widget: the #GtkWidget where @area will be rendering
- * @minimum_width: (out) (allow-none): location to store the minimum width, or %NULL
- * @natural_width: (out) (allow-none): location to store the natural width, or %NULL
+ * @minimum_width: (out) (optional): location to store the minimum width, or %NULL
+ * @natural_width: (out) (optional): location to store the natural width, or %NULL
*
* Retrieves a cell area’s initial minimum and natural width.
*
* @context: the #GtkCellAreaContext which has already been requested for widths.
* @widget: the #GtkWidget where @area will be rendering
* @width: the width for which to check the height of this area
- * @minimum_height: (out) (allow-none): location to store the minimum height, or %NULL
- * @natural_height: (out) (allow-none): location to store the natural height, or %NULL
+ * @minimum_height: (out) (optional): location to store the minimum height, or %NULL
+ * @natural_height: (out) (optional): location to store the natural height, or %NULL
*
* Retrieves a cell area’s minimum and natural height if it would be given
* the specified @width.
* @area: a #GtkCellArea
* @context: the #GtkCellAreaContext to perform this request with
* @widget: the #GtkWidget where @area will be rendering
- * @minimum_height: (out) (allow-none): location to store the minimum height, or %NULL
- * @natural_height: (out) (allow-none): location to store the natural height, or %NULL
+ * @minimum_height: (out) (optional): location to store the minimum height, or %NULL
+ * @natural_height: (out) (optional): location to store the natural height, or %NULL
*
* Retrieves a cell area’s initial minimum and natural height.
*
* @context: the #GtkCellAreaContext which has already been requested for widths.
* @widget: the #GtkWidget where @area will be rendering
* @height: the height for which to check the width of this area
- * @minimum_width: (out) (allow-none): location to store the minimum width, or %NULL
- * @natural_width: (out) (allow-none): location to store the natural width, or %NULL
+ * @minimum_width: (out) (optional): location to store the minimum width, or %NULL
+ * @natural_width: (out) (optional): location to store the natural width, or %NULL
*
* Retrieves a cell area’s minimum and natural width if it would be given
* the specified @height.
* @widget: the #GtkWidget that @area is rendering onto
* @for_size: the allocation contextual size to request for, or -1 if
* the base request for the orientation is to be returned.
- * @minimum_size: (out) (allow-none): location to store the minimum size, or %NULL
- * @natural_size: (out) (allow-none): location to store the natural size, or %NULL
+ * @minimum_size: (out) (optional): location to store the minimum size, or %NULL
+ * @natural_size: (out) (optional): location to store the natural size, or %NULL
*
* This is a convenience function for #GtkCellArea implementations
* to request size for cell renderers. It’s important to use this
/**
* gtk_cell_area_context_get_preferred_width:
* @context: a #GtkCellAreaContext
- * @minimum_width: (out) (allow-none): location to store the minimum width
- * @natural_width: (out) (allow-none): location to store the natural width
+ * @minimum_width: (out) (optional): location to store the minimum width
+ * @natural_width: (out) (optional): location to store the natural width
*
* Gets the accumulative preferred width for all rows which have been
* requested with this context.
/**
* gtk_cell_area_context_get_preferred_height:
* @context: a #GtkCellAreaContext
- * @minimum_height: (out) (allow-none): location to store the minimum height
- * @natural_height: (out) (allow-none): location to store the natural height
+ * @minimum_height: (out) (optional): location to store the minimum height
+ * @natural_height: (out) (optional): location to store the natural height
*
* Gets the accumulative preferred height for all rows which have been
* requested with this context.
* gtk_cell_area_context_get_preferred_height_for_width:
* @context: a #GtkCellAreaContext
* @width: a proposed width for allocation
- * @minimum_height: (out) (allow-none): location to store the minimum height
- * @natural_height: (out) (allow-none): location to store the natural height
+ * @minimum_height: (out) (optional): location to store the minimum height
+ * @natural_height: (out) (optional): location to store the natural height
*
* Gets the accumulative preferred height for @width for all rows
* which have been requested for the same said @width with this context.
* gtk_cell_area_context_get_preferred_width_for_height:
* @context: a #GtkCellAreaContext
* @height: a proposed height for allocation
- * @minimum_width: (out) (allow-none): location to store the minimum width
- * @natural_width: (out) (allow-none): location to store the natural width
+ * @minimum_width: (out) (optional): location to store the minimum width
+ * @natural_width: (out) (optional): location to store the natural width
*
* Gets the accumulative preferred width for @height for all rows which
* have been requested for the same said @height with this context.
/**
* gtk_cell_area_context_get_allocation:
* @context: a #GtkCellAreaContext
- * @width: (out) (allow-none): location to store the allocated width, or %NULL
- * @height: (out) (allow-none): location to store the allocated height, or %NULL
+ * @width: (out) (optional): location to store the allocated width, or %NULL
+ * @height: (out) (optional): location to store the allocated height, or %NULL
*
* Fetches the current allocation size for @context.
*
* gtk_cell_layout_set_cell_data_func:
* @cell_layout: a #GtkCellLayout
* @cell: a #GtkCellRenderer
- * @func: (allow-none): the #GtkCellLayoutDataFunc to use, or %NULL
+ * @func: (nullable): the #GtkCellLayoutDataFunc to use, or %NULL
* @func_data: (closure): user data for @func
* @destroy: destroy notify for @func_data
*
/**
* gtk_cell_renderer_get_fixed_size:
* @cell: A #GtkCellRenderer
- * @width: (out) (allow-none): location to fill in with the fixed width of the cell, or %NULL
- * @height: (out) (allow-none): location to fill in with the fixed height of the cell, or %NULL
+ * @width: (out) (optional): location to fill in with the fixed width of the cell, or %NULL
+ * @height: (out) (optional): location to fill in with the fixed height of the cell, or %NULL
*
* Fills in @width and @height with the appropriate size of @cell.
**/
/**
* gtk_cell_renderer_get_alignment:
* @cell: A #GtkCellRenderer
- * @xalign: (out) (allow-none): location to fill in with the x alignment of the cell, or %NULL
- * @yalign: (out) (allow-none): location to fill in with the y alignment of the cell, or %NULL
+ * @xalign: (out) (optional): location to fill in with the x alignment of the cell, or %NULL
+ * @yalign: (out) (optional): location to fill in with the y alignment of the cell, or %NULL
*
* Fills in @xalign and @yalign with the appropriate values of @cell.
**/
/**
* gtk_cell_renderer_get_padding:
* @cell: A #GtkCellRenderer
- * @xpad: (out) (allow-none): location to fill in with the x padding of the cell, or %NULL
- * @ypad: (out) (allow-none): location to fill in with the y padding of the cell, or %NULL
+ * @xpad: (out) (optional): location to fill in with the x padding of the cell, or %NULL
+ * @ypad: (out) (optional): location to fill in with the y padding of the cell, or %NULL
*
* Fills in @xpad and @ypad with the appropriate values of @cell.
**/
* gtk_cell_renderer_get_preferred_width:
* @cell: a #GtkCellRenderer instance
* @widget: the #GtkWidget this cell will be rendering to
- * @minimum_size: (out) (allow-none): location to store the minimum size, or %NULL
- * @natural_size: (out) (allow-none): location to store the natural size, or %NULL
+ * @minimum_size: (out) (optional): location to store the minimum size, or %NULL
+ * @natural_size: (out) (optional): location to store the natural size, or %NULL
*
* Retrieves a renderer’s natural size when rendered to @widget.
*/
* gtk_cell_renderer_get_preferred_height:
* @cell: a #GtkCellRenderer instance
* @widget: the #GtkWidget this cell will be rendering to
- * @minimum_size: (out) (allow-none): location to store the minimum size, or %NULL
- * @natural_size: (out) (allow-none): location to store the natural size, or %NULL
+ * @minimum_size: (out) (optional): location to store the minimum size, or %NULL
+ * @natural_size: (out) (optional): location to store the natural size, or %NULL
*
* Retrieves a renderer’s natural size when rendered to @widget.
*/
* @cell: a #GtkCellRenderer instance
* @widget: the #GtkWidget this cell will be rendering to
* @height: the size which is available for allocation
- * @minimum_width: (out) (allow-none): location for storing the minimum size, or %NULL
- * @natural_width: (out) (allow-none): location for storing the preferred size, or %NULL
+ * @minimum_width: (out) (optional): location for storing the minimum size, or %NULL
+ * @natural_width: (out) (optional): location for storing the preferred size, or %NULL
*
* Retrieves a cell renderers’s minimum and natural width if it were rendered to
* @widget with the specified @height.
* @cell: a #GtkCellRenderer instance
* @widget: the #GtkWidget this cell will be rendering to
* @width: the size which is available for allocation
- * @minimum_height: (out) (allow-none): location for storing the minimum size, or %NULL
- * @natural_height: (out) (allow-none): location for storing the preferred size, or %NULL
+ * @minimum_height: (out) (optional): location for storing the minimum size, or %NULL
+ * @natural_height: (out) (optional): location for storing the preferred size, or %NULL
*
* Retrieves a cell renderers’s minimum and natural height if it were rendered to
* @widget with the specified @width.
* gtk_cell_renderer_get_preferred_size:
* @cell: a #GtkCellRenderer instance
* @widget: the #GtkWidget this cell will be rendering to
- * @minimum_size: (out) (allow-none): location for storing the minimum size, or %NULL
- * @natural_size: (out) (allow-none): location for storing the natural size, or %NULL
+ * @minimum_size: (out) (optional): location for storing the minimum size, or %NULL
+ * @natural_size: (out) (optional): location for storing the natural size, or %NULL
*
* Retrieves the minimum and natural size of a cell taking
* into account the widget’s preference for height-for-width management.
/**
* gtk_cell_view_set_model:
* @cell_view: a #GtkCellView
- * @model: (allow-none): a #GtkTreeModel
+ * @model: (nullable): a #GtkTreeModel
*
* Sets the model for @cell_view. If @cell_view already has a model
* set, it will remove it before setting the new model. If @model is
/**
* gtk_cell_view_set_displayed_row:
* @cell_view: a #GtkCellView
- * @path: (allow-none): a #GtkTreePath or %NULL to unset.
+ * @path: (nullable): a #GtkTreePath or %NULL to unset.
*
* Sets the row of the model that is currently displayed
* by the #GtkCellView. If the path is unset, then the
* be displayed in rows, %GTK_ORIENTATION_VERTICAL for columns
* @colors_per_line: the number of colors to show in each row/column
* @n_colors: the total number of elements in @colors
- * @colors: (allow-none) (array length=n_colors): the colors of the palette, or %NULL
+ * @colors: (nullable) (array length=n_colors): the colors of the palette, or %NULL
*
* Adds a palette to the color chooser.
*
/**
* gtk_color_chooser_dialog_new:
- * @title: (allow-none): Title of the dialog, or %NULL
- * @parent: (allow-none): Transient parent of the dialog, or %NULL
+ * @title: (nullable): Title of the dialog, or %NULL
+ * @parent: (nullable): Transient parent of the dialog, or %NULL
*
* Creates a new `GtkColorChooserDialog`.
*
/**
* gtk_column_view_new:
- * @model: (allow-none) (transfer full): the list model to use, or %NULL
+ * @model: (nullable) (transfer full): the list model to use, or %NULL
*
* Creates a new `GtkColumnView`.
*
/**
* gtk_column_view_set_model: (attributes org.gtk.Method.set_property=model)
* @self: a #GtkColumnView
- * @model: (allow-none) (transfer none): the model to use or %NULL for none
+ * @model: (nullable) (transfer none): the model to use or %NULL for none
*
* Sets the model to use.
*
/**
* gtk_column_view_sort_by_column:
* @self: a `GtkColumnView`
- * @column: (allow-none): the `GtkColumnViewColumn` to sort by, or %NULL
+ * @column: (nullable): the `GtkColumnViewColumn` to sort by, or %NULL
* @direction: the direction to sort in
*
* Sets the sorting of the view.
/**
* gtk_column_view_column_set_factory: (attributes org.gtk.Method.set_property=factory)
* @self: a `GtkColumnViewColumn`
- * @factory: (allow-none) (transfer none): the factory to use or %NULL for none
+ * @factory: (nullable) (transfer none): the factory to use or %NULL for none
*
* Sets the `GtkListItemFactory` to use for populating list items for this
* column.
/**
* gtk_column_view_column_set_header_menu: (attributes org.gtk.Method.set_property=header-menu)
* @self: a `GtkColumnViewColumn`
- * @menu: (allow-none): a `GMenuModel`, or %NULL
+ * @menu: (nullable): a `GMenuModel`, or %NULL
*
* Sets the menu model that is used to create the context menu
* for the column header.
/**
* gtk_combo_box_set_active_iter:
* @combo_box: A `GtkComboBox`
- * @iter: (allow-none): The `GtkTreeIter`, or %NULL
+ * @iter: (nullable): The `GtkTreeIter`, or %NULL
*
* Sets the current active item to be the one referenced by @iter.
*
/**
* gtk_combo_box_set_model: (attributes org.gtk.Method.set_property=model)
* @combo_box: A `GtkComboBox`
- * @model: (allow-none): A `GtkTreeModel`
+ * @model: (nullable): A `GtkTreeModel`
*
* Sets the model used by @combo_box to be @model.
*
* gtk_combo_box_set_row_separator_func:
* @combo_box: a `GtkComboBox`
* @func: (nullable): a `GtkTreeViewRowSeparatorFunc`
- * @data: (allow-none): user data to pass to @func, or %NULL
- * @destroy: (allow-none): destroy notifier for @data, or %NULL
+ * @data: (nullable): user data to pass to @func, or %NULL
+ * @destroy: (nullable): destroy notifier for @data, or %NULL
*
* Sets the row separator function, which is used to determine
* whether a row should be drawn as a separator.
/**
* gtk_combo_box_set_active_id: (attributes org.gtk.Method.set_property=active-id)
* @combo_box: a `GtkComboBox`
- * @active_id: (allow-none): the ID of the row to select, or %NULL
+ * @active_id: (nullable): the ID of the row to select, or %NULL
*
* Changes the active row of @combo_box to the one that has an ID equal to
* @active_id.
/**
* gtk_combo_box_set_child: (attributes org.gtk.Method.set_property=child)
* @combo_box: a `GtkComboBox`
- * @child: (allow-none): the child widget
+ * @child: (nullable): the child widget
*
* Sets the child widget of @combo_box.
*/
/**
* gtk_combo_box_text_append:
* @combo_box: A `GtkComboBoxText`
- * @id: (allow-none): a string ID for this value, or %NULL
+ * @id: (nullable): a string ID for this value, or %NULL
* @text: A string
*
* Appends @text to the list of strings stored in @combo_box.
/**
* gtk_combo_box_text_prepend:
* @combo_box: A `GtkComboBox`
- * @id: (allow-none): a string ID for this value, or %NULL
+ * @id: (nullable): a string ID for this value, or %NULL
* @text: a string
*
* Prepends @text to the list of strings stored in @combo_box.
* gtk_combo_box_text_insert:
* @combo_box: A `GtkComboBoxText`
* @position: An index to insert @text
- * @id: (allow-none): a string ID for this value, or %NULL
+ * @id: (nullable): a string ID for this value, or %NULL
* @text: A string to display
*
* Inserts @text at @position in the list of strings stored in @combo_box.
/**
* gtk_constraint_guide_get_min_size:
* @guide: a `GtkConstraintGuide` object
- * @width: (allow-none): return location for the minimum width
- * @height: (allow-none): return location for the minimum height
+ * @width: (nullable): return location for the minimum width
+ * @height: (nullable): return location for the minimum height
*
* Gets the minimum size of @guide.
*/
/**
* gtk_constraint_guide_get_nat_size:
* @guide: a `GtkConstraintGuide` object
- * @width: (allow-none): return location for the natural width
- * @height: (allow-none): return location for the natural height
+ * @width: (nullable): return location for the natural width
+ * @height: (nullable): return location for the natural height
*
* Gets the natural size of @guide.
*/
/**
* gtk_constraint_guide_get_max_size:
* @guide: a `GtkConstraintGuide` object
- * @width: (allow-none): return location for the maximum width
- * @height: (allow-none): return location for the maximum height
+ * @width: (nullable): return location for the maximum width
+ * @height: (nullable): return location for the maximum height
*
* Gets the maximum size of @guide.
*/
* _gtk_css_lookup_set:
* @lookup: the lookup
* @id: id of the property to set, see _gtk_style_property_get_id()
- * @section: (allow-none): The @section the value was defined in or %NULL
+ * @section: (nullable): The @section the value was defined in or %NULL
* @value: the “cascading value” to use
*
* Sets the @value for a given @id. No value may have been set for @id
* gtk_css_provider_load_named:
* @provider: a `GtkCssProvider`
* @name: A theme name
- * @variant: (allow-none): variant to load, for example, "dark", or
+ * @variant: (nullable): variant to load, for example, "dark", or
* %NULL for the default
*
* Loads a theme from the usual theme paths.
/**
* gtk_custom_paper_unix_dialog_new:
- * @title: (allow-none): the title of the dialog, or %NULL
- * @parent: (allow-none): transient parent of the dialog, or %NULL
+ * @title: (nullable): the title of the dialog, or %NULL
+ * @parent: (nullable): transient parent of the dialog, or %NULL
*
* Creates a new custom paper dialog.
*
/**
* gtk_dialog_new_with_buttons:
- * @title: (allow-none): Title of the dialog, or %NULL
- * @parent: (allow-none): Transient parent of the dialog, or %NULL
+ * @title: (nullable): Title of the dialog, or %NULL
+ * @parent: (nullable): Transient parent of the dialog, or %NULL
* @flags: from `GtkDialogFlags`
- * @first_button_text: (allow-none): text to go in first button, or %NULL
+ * @first_button_text: (nullable): text to go in first button, or %NULL
* @...: response ID for first button, then additional buttons, ending with %NULL
*
* Creates a new `GtkDialog` with the given title and transient parent.
/**
* gtk_directory_list_new:
- * @file: (allow-none): The file to query
- * @attributes: (allow-none): The attributes to query with
+ * @file: (nullable): The file to query
+ * @attributes: (nullable): The attributes to query with
*
* Creates a new `GtkDirectoryList`.
*
/**
* gtk_directory_list_set_file: (attributes org.gtk.Method.set_property=file)
* @self: a `GtkDirectoryList`
- * @file: (allow-none): the #GFile to be enumerated
+ * @file: (nullable): the #GFile to be enumerated
*
* Sets the @file to be enumerated and starts the enumeration.
*
/**
* gtk_directory_list_set_attributes: (attributes org.gtk.Method.set_property=attributes)
* @self: a `GtkDirectoryList`
- * @attributes: (allow-none): the attributes to enumerate
+ * @attributes: (nullable): the attributes to enumerate
*
* Sets the @attributes to be enumerated and starts the enumeration.
*
/**
* gtk_drawing_area_set_draw_func:
* @self: a `GtkDrawingArea`
- * @draw_func: (allow-none): callback that lets you draw
+ * @draw_func: (nullable): callback that lets you draw
* the drawing area's contents
* @user_data: (closure): user data passed to @draw_func
* @destroy: destroy notifier for @user_data
/**
* gtk_drop_down_new:
- * @model: (transfer full) (allow-none): the model to use or %NULL for none
- * @expression: (transfer full) (allow-none): the expression to use or %NULL for none
+ * @model: (transfer full) (nullable): the model to use or %NULL for none
+ * @expression: (transfer full) (nullable): the expression to use or %NULL for none
*
* Creates a new `GtkDropDown`.
*
/**
* gtk_drop_down_set_model: (attributes org.gtk.Method.set_property=model)
* @self: a `GtkDropDown`
- * @model: (allow-none) (transfer none): the model to use or %NULL for none
+ * @model: (nullable) (transfer none): the model to use or %NULL for none
*
* Sets the `GListModel` to use.
*/
/**
* gtk_drop_down_set_factory: (attributes org.gtk.Method.set_property=factory)
* @self: a `GtkDropDown`
- * @factory: (allow-none) (transfer none): the factory to use or %NULL for none
+ * @factory: (nullable) (transfer none): the factory to use or %NULL for none
*
* Sets the `GtkListItemFactory` to use for populating list items.
**/
/**
* gtk_drop_down_set_list_factory: (attributes org.gtk.Method.set_property=list-factory)
* @self: a `GtkDropDown`
- * @factory: (allow-none) (transfer none): the factory to use or %NULL for none
+ * @factory: (nullable) (transfer none): the factory to use or %NULL for none
*
* Sets the `GtkListItemFactory` to use for populating list items in the popup.
*/
/**
* gtk_editable_get_selection_bounds:
* @editable: a `GtkEditable`
- * @start_pos: (out) (allow-none): location to store the starting position, or %NULL
- * @end_pos: (out) (allow-none): location to store the end position, or %NULL
+ * @start_pos: (out) (optional): location to store the starting position, or %NULL
+ * @end_pos: (out) (optional): location to store the end position, or %NULL
*
* Retrieves the selection bound of the editable.
*
* gtk_entry_set_icon_from_paintable:
* @entry: a `GtkEntry`
* @icon_pos: Icon position
- * @paintable: (allow-none): A `GdkPaintable`, or %NULL
+ * @paintable: (nullable): A `GdkPaintable`, or %NULL
*
* Sets the icon shown in the specified position using a `GdkPaintable`.
*
* gtk_entry_set_icon_from_icon_name:
* @entry: A `GtkEntry`
* @icon_pos: The position at which to set the icon
- * @icon_name: (allow-none): An icon name, or %NULL
+ * @icon_name: (nullable): An icon name, or %NULL
*
* Sets the icon shown in the entry at the specified position
* from the current icon theme.
* gtk_entry_set_icon_from_gicon:
* @entry: A `GtkEntry`
* @icon_pos: The position at which to set the icon
- * @icon: (allow-none): The icon to set, or %NULL
+ * @icon: (nullable): The icon to set, or %NULL
*
* Sets the icon shown in the entry at the specified position
* from the current icon theme.
* gtk_entry_set_icon_tooltip_text:
* @entry: a `GtkEntry`
* @icon_pos: the icon position
- * @tooltip: (allow-none): the contents of the tooltip for the
+ * @tooltip: (nullable): the contents of the tooltip for the
* icon, or %NULL
*
* Sets @tooltip as the contents of the tooltip for the icon
* gtk_entry_set_icon_tooltip_markup:
* @entry: a `GtkEntry`
* @icon_pos: the icon position
- * @tooltip: (allow-none): the contents of the tooltip for the
+ * @tooltip: (nullable): the contents of the tooltip for the
* icon, or %NULL
*
* Sets @tooltip as the contents of the tooltip for the icon at
/**
* gtk_entry_set_completion: (attributes org.gtk.Method.set_property=completion)
* @entry: A `GtkEntry`
- * @completion: (allow-none): The `GtkEntryCompletion` or %NULL
+ * @completion: (nullable): The `GtkEntryCompletion` or %NULL
*
* Sets @completion to be the auxiliary completion object
* to use with @entry.
/**
* gtk_entry_set_extra_menu: (attributes org.gtk.Method.set_property=extra-menu)
* @entry: a `GtkEntry`
- * @model: (allow-none): a `GMenuModel`
+ * @model: (nullable): a `GMenuModel`
*
* Sets a menu model to add when constructing
* the context menu for @entry.
/**
* gtk_entry_buffer_new:
- * @initial_chars: (allow-none): initial buffer text, or %NULL
+ * @initial_chars: (nullable): initial buffer text, or %NULL
* @n_initial_chars: number of characters in @initial_chars, or -1
*
* Create a new `GtkEntryBuffer` object.
/**
* gtk_entry_completion_set_model: (attributes org.gtk.Method.set_property=model)
* @completion: a `GtkEntryCompletion`
- * @model: (allow-none): the `GtkTreeModel`
+ * @model: (nullable): the `GtkTreeModel`
*
* Sets the model for a `GtkEntryCompletion`.
*
/**
* gtk_expander_set_child: (attributes org.gtk.Method.set_property=child)
* @expander: a `GtkExpander`
- * @child: (allow-none): the child widget
+ * @child: (nullable): the child widget
*
* Sets the child widget of @expander.
*/
* gtk_file_chooser_set_file:
* @chooser: a `GtkFileChooser`
* @file: the `GFile` to set as current
- * @error: (allow-none): location to store the error, or %NULL to ignore errors.
+ * @error: (nullable): location to store the error, or %NULL to ignore errors.
*
* Sets @file as the current filename for the file chooser.
*
/**
* gtk_file_chooser_dialog_new:
- * @title: (allow-none): Title of the dialog, or %NULL
- * @parent: (allow-none): Transient parent of the dialog, or %NULL
+ * @title: (nullable): Title of the dialog, or %NULL
+ * @parent: (nullable): Transient parent of the dialog, or %NULL
* @action: Open or save mode for the dialog
- * @first_button_text: (allow-none): text to go in the first button, or %NULL
+ * @first_button_text: (nullable): text to go in the first button, or %NULL
* @...: response ID for the first button, then additional (button, id) pairs, ending with %NULL
*
* Creates a new `GtkFileChooserDialog`.
/**
* gtk_file_chooser_native_set_accept_label: (attributes org.gtk.Method.set_property=accept-label)
* @self: a `GtkFileChooserNative`
- * @accept_label: (allow-none): custom label or %NULL for the default
+ * @accept_label: (nullable): custom label or %NULL for the default
*
* Sets the custom label text for the accept button.
*
/**
* gtk_file_chooser_native_set_cancel_label: (attributes org.gtk.Method.set_property=cancel-label)
* @self: a `GtkFileChooserNative`
- * @cancel_label: (allow-none): custom label or %NULL for the default
+ * @cancel_label: (nullable): custom label or %NULL for the default
*
* Sets the custom label text for the cancel button.
*
/**
* gtk_file_chooser_native_new:
- * @title: (allow-none): Title of the native, or %NULL
- * @parent: (allow-none): Transient parent of the native, or %NULL
+ * @title: (nullable): Title of the native, or %NULL
+ * @parent: (nullable): Transient parent of the native, or %NULL
* @action: Open or save mode for the dialog
- * @accept_label: (allow-none): text to go in the accept button, or %NULL for the default
- * @cancel_label: (allow-none): text to go in the cancel button, or %NULL for the default
+ * @accept_label: (nullable): text to go in the accept button, or %NULL for the default
+ * @cancel_label: (nullable): text to go in the cancel button, or %NULL for the default
*
* Creates a new `GtkFileChooserNative`.
*
/**
* gtk_file_filter_set_name: (attributes org.gtk.Method.set_property=name)
* @filter: a `GtkFileFilter`
- * @name: (allow-none): the human-readable-name for the filter, or %NULL
+ * @name: (nullable): the human-readable-name for the filter, or %NULL
* to remove any existing name.
*
* Sets a human-readable name of the filter.
/**
* _gtk_file_system_model_new_for_directory:
* @directory: the directory to show.
- * @attributes: (allow-none): attributes to immediately load or %NULL for all
+ * @attributes: (nullable): attributes to immediately load or %NULL for all
* @get_func: function that the model should call to query data about a file
* @get_data: user data to pass to the @get_func
* @n_columns: number of columns
/**
* _gtk_file_system_model_set_filter:
* @mode: a #GtkFileSystemModel
- * @filter: (allow-none): %NULL or filter to use
+ * @filter: (nullable): %NULL or filter to use
*
* Sets a filter to be used for deciding if a row should be visible or not.
* Whether this filter applies to directories can be toggled with
/**
* gtk_filter_list_model_new:
- * @model: (allow-none) (transfer full): the model to sort, or %NULL
- * @filter: (allow-none) (transfer full): filter or %NULL to not filter items
+ * @model: (nullable) (transfer full): the model to sort, or %NULL
+ * @filter: (nullable) (transfer full): filter or %NULL to not filter items
*
* Creates a new `GtkFilterListModel` that will filter @model using the given
* @filter.
/**
* gtk_filter_list_model_set_filter: (attributes org.gtk.Method.set_property=filter)
* @self: a `GtkFilterListModel`
- * @filter: (allow-none) (transfer none): filter to use or %NULL to not filter items
+ * @filter: (nullable) (transfer none): filter to use or %NULL to not filter items
*
* Sets the filter used to filter items.
**/
/**
* gtk_filter_list_model_set_model: (attributes org.gtk.Method.set_property=model)
* @self: a `GtkFilterListModel`
- * @model: (allow-none): The model to be filtered
+ * @model: (nullable): The model to be filtered
*
* Sets the model to be filtered.
*
/**
* gtk_flow_box_child_set_child: (attributes org.gtk.Method.set_property=child)
* @self: a `GtkFlowBoxChild`
- * @child: (allow-none): the child widget
+ * @child: (nullable): the child widget
*
* Sets the child widget of @self.
*/
/**
* gtk_flow_box_bind_model:
* @box: a `GtkFlowBox`
- * @model: (allow-none): the `GListModel` to be bound to @box
+ * @model: (nullable): the `GListModel` to be bound to @box
* @create_widget_func: a function that creates widgets for items
* @user_data: (closure): user data passed to @create_widget_func
* @user_data_free_func: function for freeing @user_data
/**
* gtk_flow_box_set_filter_func:
* @box: a `GtkFlowBox`
- * @filter_func: (allow-none): callback that
+ * @filter_func: (nullable): callback that
* lets you filter which children to show
* @user_data: (closure): user data passed to @filter_func
* @destroy: destroy notifier for @user_data
/**
* gtk_flow_box_set_sort_func:
* @box: a `GtkFlowBox`
- * @sort_func: (allow-none): the sort function
+ * @sort_func: (nullable): the sort function
* @user_data: (closure): user data passed to @sort_func
* @destroy: destroy notifier for @user_data
*
/**
* gtk_font_chooser_set_filter_func:
* @fontchooser: a `GtkFontChooser`
- * @filter: (allow-none): a `GtkFontFilterFunc`, or %NULL
+ * @filter: (nullable): a `GtkFontFilterFunc`, or %NULL
* @user_data: (closure): data to pass to @filter
* @destroy: function to call to free @data when it is no longer needed
*
/**
* gtk_font_chooser_set_font_map:
* @fontchooser: a `GtkFontChooser`
- * @fontmap: (allow-none): a `PangoFontMap`
+ * @fontmap: (nullable): a `PangoFontMap`
*
* Sets a custom font map to use for this font chooser widget.
*
/**
* gtk_font_chooser_dialog_new:
- * @title: (allow-none): Title of the dialog, or %NULL
- * @parent: (allow-none): Transient parent of the dialog, or %NULL
+ * @title: (nullable): Title of the dialog, or %NULL
+ * @parent: (nullable): Transient parent of the dialog, or %NULL
*
* Creates a new `GtkFontChooserDialog`.
*
/**
* gtk_frame_new:
- * @label: (allow-none): the text to use as the label of the frame
+ * @label: (nullable): the text to use as the label of the frame
*
* Creates a new `GtkFrame`, with optional label @label.
*
/**
* gtk_frame_set_label: (attributes org.gtk.Method.set_property=label)
* @frame: a `GtkFrame`
- * @label: (allow-none): the text to use as the label of the frame
+ * @label: (nullable): the text to use as the label of the frame
*
* Creates a new `GtkLabel` with the @label and sets it as the frame's
* label widget.
/**
* gtk_frame_set_child: (attributes org.gtk.Method.set_property=child)
* @frame: a `GtkFrame`
- * @child: (allow-none): the child widget
+ * @child: (nullable): the child widget
*
* Sets the child widget of @frame.
*/
/**
* gtk_gesture_get_point:
* @gesture: a `GtkGesture`
- * @sequence: (allow-none): a `GdkEventSequence`, or %NULL for pointer events
- * @x: (out) (allow-none): return location for X axis of the sequence coordinates
- * @y: (out) (allow-none): return location for Y axis of the sequence coordinates
+ * @sequence: (nullable): a `GdkEventSequence`, or %NULL for pointer events
+ * @x: (out) (optional): return location for X axis of the sequence coordinates
+ * @y: (out) (optional): return location for Y axis of the sequence coordinates
*
* If @sequence is currently being interpreted by @gesture,
* returns %TRUE and fills in @x and @y with the last coordinates
/**
* GtkGLArea::create-context:
* @area: the `GtkGLArea` that emitted the signal
- * @error: (allow-none): location to store error information on failure
+ * @error: (nullable): location to store error information on failure
*
* Emitted when the widget is being realized.
*
/**
* gtk_gl_area_set_error:
* @area: a `GtkGLArea`
- * @error: (allow-none): a new `GError`, or %NULL to unset the error
+ * @error: (nullable): a new `GError`, or %NULL to unset the error
*
* Sets an error on the area which will be shown instead of the
* GL rendering.
* gtk_grid_attach_next_to:
* @grid: a `GtkGrid`
* @child: the widget to add
- * @sibling: (allow-none): the child of @grid that @child will be placed
+ * @sibling: (nullable): the child of @grid that @child will be placed
* next to, or %NULL to place @child at the beginning or end
* @side: the side of @sibling that @child is positioned next to
* @width: the number of columns that @child will span
/**
* gtk_grid_view_new:
- * @model: (allow-none) (transfer full): the model to use, or %NULL
- * @factory: (allow-none) (transfer full): The factory to populate items with, or %NULL
+ * @model: (nullable) (transfer full): the model to use, or %NULL
+ * @factory: (nullable) (transfer full): The factory to populate items with, or %NULL
*
* Creates a new `GtkGridView` that uses the given @factory for
* mapping items to widgets.
/**
* gtk_grid_view_set_model: (attributes org.gtk.Method.set_property=model)
* @self: a `GtkGridView`
- * @model: (allow-none) (transfer none): the model to use or %NULL for none
+ * @model: (nullable) (transfer none): the model to use or %NULL for none
*
* Sets the imodel to use.
*
/**
* gtk_grid_view_set_factory: (attributes org.gtk.Method.set_property=factory)
* @self: a `GtkGridView`
- * @factory: (allow-none) (transfer none): the factory to use or %NULL for none
+ * @factory: (nullable) (transfer none): the factory to use or %NULL for none
*
* Sets the `GtkListItemFactory` to use for populating list items.
*/
/**
* gtk_header_bar_set_title_widget:
* @bar: a `GtkHeaderBar`
- * @title_widget: (allow-none): a widget to use for a title
+ * @title_widget: (nullable): a widget to use for a title
*
* Sets the title for the `GtkHeaderBar`.
*
/**
* gtk_header_bar_set_decoration_layout: (attributes org.gtk.Method.set_property=decoration-layout)
* @bar: a `GtkHeaderBar`
- * @layout: (allow-none): a decoration layout, or %NULL to
+ * @layout: (nullable): a decoration layout, or %NULL to
* unset the layout
*
* Sets the decoration layout for this header bar.
/**
* gtk_icon_theme_set_theme_name:
* @self: a `GtkIconTheme`
- * @theme_name: (allow-none): name of icon theme to use instead of
+ * @theme_name: (nullable): name of icon theme to use instead of
* configured theme, or %NULL to unset a previously set custom theme
*
* Sets the name of the icon theme that the `GtkIconTheme` object uses
* @snapshot: a `GdkSnapshot` to snapshot to
* @width: width to snapshot in
* @height: height to snapshot in
- * @foreground_color: (allow-none): a `GdkRGBA` representing the foreground color
+ * @foreground_color: (nullable): a `GdkRGBA` representing the foreground color
* of the icon or %NULL to use the default color.
- * @success_color: (allow-none): a `GdkRGBA` representing the warning color
+ * @success_color: (nullable): a `GdkRGBA` representing the warning color
* of the icon or %NULL to use the default color
- * @warning_color: (allow-none): a `GdkRGBA` representing the warning color
+ * @warning_color: (nullable): a `GdkRGBA` representing the warning color
* of the icon or %NULL to use the default color
- * @error_color: (allow-none): a `GdkRGBA` representing the error color
+ * @error_color: (nullable): a `GdkRGBA` representing the error color
* of the icon or %NULL to use the default color
*
* Snapshots the `GtkIconPaintable`.
* gtk_icon_view_set_cursor:
* @icon_view: A #GtkIconView
* @path: A #GtkTreePath
- * @cell: (allow-none): One of the cell renderers of @icon_view, or %NULL
+ * @cell: (nullable): One of the cell renderers of @icon_view, or %NULL
* @start_editing: %TRUE if the specified cell should start being edited.
*
* Sets the current keyboard focus to be at @path, and selects it. This is
/**
* gtk_icon_view_get_cursor:
* @icon_view: A #GtkIconView
- * @path: (out) (allow-none) (transfer full): Return location for the current
+ * @path: (out) (optional) (transfer full): Return location for the current
* cursor path
- * @cell: (out) (allow-none) (transfer none): Return location the current
+ * @cell: (out) (optional) (transfer none): Return location the current
* focus cell
*
* Fills in @path and @cell with the current cursor path and cell.
* @icon_view: A #GtkIconView.
* @x: The x position to be identified
* @y: The y position to be identified
- * @path: (out) (allow-none): Return location for the path, or %NULL
- * @cell: (out) (allow-none) (transfer none): Return location for the renderer
+ * @path: (out) (optional): Return location for the path, or %NULL
+ * @cell: (out) (optional) (transfer none): Return location for the renderer
* responsible for the cell at (@x, @y), or %NULL
*
* Gets the path and cell for the icon at the given position.
* gtk_icon_view_get_cell_rect:
* @icon_view: a #GtkIconView
* @path: a #GtkTreePath
- * @cell: (allow-none): a #GtkCellRenderer or %NULL
+ * @cell: (nullable): a #GtkCellRenderer or %NULL
* @rect: (out): rectangle to fill with cell rect
*
* Fills the bounding rectangle in widget coordinates for the cell specified by
* @icon_view: a #GtkIconView
* @tooltip: a #GtkTooltip
* @path: a #GtkTreePath
- * @cell: (allow-none): a #GtkCellRenderer or %NULL
+ * @cell: (nullable): a #GtkCellRenderer or %NULL
*
* Sets the tip area of @tooltip to the area which @cell occupies in
* the item pointed to by @path. See also gtk_tooltip_set_tip_area().
* @x: the x coordinate (relative to widget coordinates)
* @y: the y coordinate (relative to widget coordinates)
* @keyboard_tip: whether this is a keyboard tooltip or not
- * @model: (out) (allow-none) (transfer none): a pointer to receive a `GtkTreeModel`
- * @path: (out) (allow-none): a pointer to receive a `GtkTreePath`
- * @iter: (out) (allow-none): a pointer to receive a `GtkTreeIter`
+ * @model: (out) (optional) (transfer none): a pointer to receive a `GtkTreeModel`
+ * @path: (out) (optional): a pointer to receive a `GtkTreePath`
+ * @iter: (out) (optional): a pointer to receive a `GtkTreeIter`
*
* This function is supposed to be used in a #GtkWidget::query-tooltip
* signal handler for #GtkIconView. The @x, @y and @keyboard_tip values
/**
* gtk_icon_view_get_visible_range:
* @icon_view: A #GtkIconView
- * @start_path: (out) (allow-none): Return location for start of region
- * @end_path: (out) (allow-none): Return location for end of region
+ * @start_path: (out) (optional): Return location for start of region
+ * @end_path: (out) (optional): Return location for end of region
*
* Sets @start_path and @end_path to be the first and last visible path.
* Note that there may be invisible paths in between.
/**
* gtk_icon_view_set_model:
* @icon_view: A #GtkIconView.
- * @model: (allow-none): The model.
+ * @model: (nullable): The model.
*
* Sets the model for a #GtkIconView.
* If the @icon_view already has a model set, it will remove
/**
* gtk_icon_view_set_drag_dest_item:
* @icon_view: a #GtkIconView
- * @path: (allow-none): The path of the item to highlight, or %NULL.
+ * @path: (nullable): The path of the item to highlight, or %NULL.
* @pos: Specifies where to drop, relative to the item
*
* Sets the item that is highlighted for feedback.
/**
* gtk_icon_view_get_drag_dest_item:
* @icon_view: a #GtkIconView
- * @path: (out) (allow-none): Return location for the path of
+ * @path: (out) (optional): Return location for the path of
* the highlighted item
- * @pos: (out) (allow-none): Return location for the drop position
+ * @pos: (out) (optional): Return location for the drop position
*
* Gets information about the item that is highlighted for feedback.
*/
* @icon_view: a #GtkIconView
* @drag_x: the position to determine the destination item for
* @drag_y: the position to determine the destination item for
- * @path: (out) (allow-none): Return location for the path of the item,
+ * @path: (out) (optional): Return location for the path of the item,
* or %NULL.
- * @pos: (out) (allow-none): Return location for the drop position, or %NULL
+ * @pos: (out) (optional): Return location for the drop position, or %NULL
*
* Determines the destination item for a given position.
*
/**
* gtk_image_new_from_pixbuf:
- * @pixbuf: (allow-none): a `GdkPixbuf`, or %NULL
+ * @pixbuf: (nullable): a `GdkPixbuf`, or %NULL
*
* Creates a new `GtkImage` displaying @pixbuf.
*
/**
* gtk_image_new_from_paintable:
- * @paintable: (allow-none): a `GdkPaintable`, or %NULL
+ * @paintable: (nullable): a `GdkPaintable`, or %NULL
*
* Creates a new `GtkImage` displaying @paintable.
*
/**
* gtk_image_set_from_file: (attributes org.gtk.Method.set_property=file)
* @image: a `GtkImage`
- * @filename: (type filename) (allow-none): a filename or %NULL
+ * @filename: (type filename) (nullable): a filename or %NULL
*
* Sets a `GtkImage` to show a file.
*
/**
* gtk_image_set_from_resource: (attributes org.gtk.Method.set_property=resource)
* @image: a `GtkImage`
- * @resource_path: (allow-none): a resource path or %NULL
+ * @resource_path: (nullable): a resource path or %NULL
*
* Sets a `GtkImage` to show a resource.
*
/**
* gtk_image_set_from_pixbuf: (attributes org.gtk.Method.set_property=paintable)
* @image: a `GtkImage`
- * @pixbuf: (allow-none): a `GdkPixbuf` or `NULL`
+ * @pixbuf: (nullable): a `GdkPixbuf` or `NULL`
*
* Sets a `GtkImage` to show a `GdkPixbuf`.
*
* The returned string is owned by the `GtkImage` and should not
* be freed.
*
- * Returns: (transfer none) (allow-none): the icon name, or %NULL
+ * Returns: (transfer none) (nullable): the icon name, or %NULL
*/
const char *
gtk_image_get_icon_name (GtkImage *image)
* The caller of this function does not own a reference to the
* returned `GIcon`.
*
- * Returns: (transfer none) (allow-none): a `GIcon`, or %NULL
+ * Returns: (transfer none) (nullable): a `GIcon`, or %NULL
**/
GIcon *
gtk_image_get_gicon (GtkImage *image)
/**
* gtk_im_context_set_client_widget:
* @context: a `GtkIMContext`
- * @widget: (allow-none): the client widget. This may be %NULL to indicate
+ * @widget: (nullable): the client widget. This may be %NULL to indicate
* that the previous client widget no longer exists.
*
* Set the client widget for the input context.
/**
* gtk_info_bar_new_with_buttons:
- * @first_button_text: (allow-none): ext to go in first button, or %NULL
+ * @first_button_text: (nullable): ext to go in first button, or %NULL
* @...: response ID for first button, then additional buttons, ending
* with %NULL
*
/**
* gtk_label_set_extra_menu: (attributes org.gtk.Method.set_property=extra-menu)
* @self: a `GtkLabel`
- * @model: (allow-none): a `GMenuModel`
+ * @model: (nullable): a `GMenuModel`
*
* Sets a menu model to add when constructing
* the context menu for @label.
/**
* gtk_level_bar_remove_offset_value:
* @self: a `GtkLevelBar`
- * @name: (allow-none): the name of an offset in the bar
+ * @name: (nullable): the name of an offset in the bar
*
* Removes an offset marker from a `GtkLevelBar`.
*
/**
* gtk_level_bar_get_offset_value:
* @self: a `GtkLevelBar`
- * @name: (allow-none): the name of an offset in the bar
+ * @name: (nullable): the name of an offset in the bar
* @value: (out): location where to store the value
*
* Fetches the value specified for the offset marker @name in @self.
/**
* gtk_link_button_new_with_label:
* @uri: a valid URI
- * @label: (allow-none): the text of the button
+ * @label: (nullable): the text of the button
*
* Creates a new `GtkLinkButton` containing a label.
*
* @across: position in pixels in the direction cross to the list
* @along: position in pixels in the direction of the list
* @pos: (out caller-allocates): set to the looked up position
- * @area: (out caller-allocates) (allow-none): set to the area occupied
+ * @area: (out caller-allocates) (optional): set to the area occupied
* by the returned position
*
* Given a coordinate in list coordinates, determine the position of the
* gtk_list_base_get_allocation_along:
* @self: a #GtkListBase
* @pos: item to get the size of
- * @offset: (out caller-allocates) (allow-none) set to the offset
+ * @offset: (out caller-allocates) (optional): set to the offset
* of the top/left of the item
- * @size: (out caller-allocates) (allow-none) set to the size of
+ * @size: (out caller-allocates) (optional): set to the size of
* the item in the direction
*
* Computes the allocation of the item in the direction along the sizing
* gtk_list_base_get_allocation_across:
* @self: a #GtkListBase
* @pos: item to get the size of
- * @offset: (out caller-allocates) (allow-none) set to the offset
+ * @offset: (out caller-allocates) (optional): set to the offset
* of the top/left of the item
- * @size: (out caller-allocates) (allow-none) set to the size of
+ * @size: (out caller-allocates) (optional): set to the size of
* the item in the direction
*
* Computes the allocation of the item in the direction across to the sizing
/**
* gtk_list_box_select_row:
* @box: a `GtkListBox`
- * @row: (allow-none): The row to select or %NULL
+ * @row: (nullable): The row to select or %NULL
*
* Make @row the currently selected row.
*/
/**
* gtk_list_box_set_placeholder:
* @box: a `GtkListBox`
- * @placeholder: (allow-none): a #GtkWidget or %NULL
+ * @placeholder: (nullable): a #GtkWidget or %NULL
*
* Sets the placeholder widget that is shown in the list when
* it doesn't display any visible children.
/**
* gtk_list_box_set_adjustment:
* @box: a `GtkListBox`
- * @adjustment: (allow-none): the adjustment, or %NULL
+ * @adjustment: (nullable): the adjustment, or %NULL
*
* Sets the adjustment (if any) that the widget uses to
* for vertical scrolling.
/**
* gtk_list_box_set_filter_func:
* @box: a `GtkListBox`
- * @filter_func: (allow-none): callback that lets you filter which rows to show
+ * @filter_func: (nullable): callback that lets you filter which rows to show
* @user_data: (closure): user data passed to @filter_func
* @destroy: destroy notifier for @user_data
*
/**
* gtk_list_box_set_header_func:
* @box: a `GtkListBox`
- * @update_header: (allow-none): callback that lets you add row headers
+ * @update_header: (nullable): callback that lets you add row headers
* @user_data: (closure): user data passed to @update_header
* @destroy: destroy notifier for @user_data
*
/**
* gtk_list_box_set_sort_func:
* @box: a `GtkListBox`
- * @sort_func: (allow-none): the sort function
+ * @sort_func: (nullable): the sort function
* @user_data: (closure): user data passed to @sort_func
* @destroy: destroy notifier for @user_data
*
/**
* gtk_list_box_row_set_child: (attributes org.gtk.Method.set_property=child)
* @row: a `GtkListBoxRow`
- * @child: (allow-none): the child widget
+ * @child: (nullable): the child widget
*
* Sets the child widget of @self.
*/
/**
* gtk_list_box_row_set_header:
* @row: a `GtkListBoxRow`
- * @header: (allow-none): the header, or %NULL
+ * @header: (nullable): the header, or %NULL
*
* Sets the current header of the @row.
*
/**
* GtkListBoxUpdateHeaderFunc:
* @row: the row to update
- * @before: (allow-none): the row before @row, or %NULL if it is first
+ * @before: (nullable): the row before @row, or %NULL if it is first
* @user_data: (closure): user data
*
* Whenever @row changes or which row is before @row changes this
/*
* gtk_list_item_manager_release_list_item:
* @self: a #GtkListItemManager
- * @change: (allow-none): The change associated with this release or
+ * @change: (nullable): The change associated with this release or
* %NULL if this is a final removal
* @item: an item previously acquired with
* gtk_list_item_manager_acquire_list_item()
* gtk_list_store_insert_before:
* @list_store: A #GtkListStore
* @iter: (out): An unset #GtkTreeIter to set to the new row
- * @sibling: (allow-none): A valid #GtkTreeIter, or %NULL
+ * @sibling: (nullable): A valid #GtkTreeIter, or %NULL
*
* Inserts a new row before @sibling. If @sibling is %NULL, then the row will
* be appended to the end of the list. @iter will be changed to point to this
* gtk_list_store_insert_after:
* @list_store: A #GtkListStore
* @iter: (out): An unset #GtkTreeIter to set to the new row
- * @sibling: (allow-none): A valid #GtkTreeIter, or %NULL
+ * @sibling: (nullable): A valid #GtkTreeIter, or %NULL
*
* Inserts a new row after @sibling. If @sibling is %NULL, then the row will be
* prepended to the beginning of the list. @iter will be changed to point to
* gtk_list_store_move_before:
* @store: A #GtkListStore.
* @iter: A #GtkTreeIter.
- * @position: (allow-none): A #GtkTreeIter, or %NULL.
+ * @position: (nullable): A #GtkTreeIter, or %NULL.
*
* Moves @iter in @store to the position before @position. Note that this
* function only works with unsorted stores. If @position is %NULL, @iter
* gtk_list_store_move_after:
* @store: A #GtkListStore.
* @iter: A #GtkTreeIter.
- * @position: (allow-none): A #GtkTreeIter or %NULL.
+ * @position: (nullable): A #GtkTreeIter or %NULL.
*
* Moves @iter in @store to the position after @position. Note that this
* function only works with unsorted stores. If @position is %NULL, @iter
/**
* gtk_list_view_new:
- * @model: (allow-none) (transfer full): the model to use, or %NULL
- * @factory: (allow-none) (transfer full): The factory to populate items with, or %NULL
+ * @model: (nullable) (transfer full): the model to use, or %NULL
+ * @factory: (nullable) (transfer full): The factory to populate items with, or %NULL
*
* Creates a new `GtkListView` that uses the given @factory for
* mapping items to widgets.
/**
* gtk_list_view_set_model: (attributes org.gtk.Method.set_property=model)
* @self: a `GtkListView`
- * @model: (allow-none) (transfer none): the model to use or %NULL for none
+ * @model: (nullable) (transfer none): the model to use or %NULL for none
*
* Sets the model to use.
*
/**
* gtk_list_view_set_factory: (attributes org.gtk.Method.set_property=factory)
* @self: a `GtkListView`
- * @factory: (allow-none) (transfer none): the factory to use or %NULL for none
+ * @factory: (nullable) (transfer none): the factory to use or %NULL for none
*
* Sets the `GtkListItemFactory` to use for populating list items.
*/
/**
* gtk_lock_button_new:
- * @permission: (allow-none): a `GPermission`
+ * @permission: (nullable): a `GPermission`
*
* Creates a new lock button which reflects the @permission.
*
/**
* gtk_lock_button_set_permission: (attributes org.gtk.Method.set_property=permission)
* @button: a `GtkLockButton`
- * @permission: (allow-none): a `GPermission` object, or %NULL
+ * @permission: (nullable): a `GPermission` object, or %NULL
*
* Sets the `GPermission` object that controls @button.
*/
/**
* gtk_map_list_model_new:
- * @model: (transfer full) (allow-none): The model to map or %NULL for none
- * @map_func: (allow-none): map function or %NULL to not map items
+ * @model: (transfer full) (nullable): The model to map or %NULL for none
+ * @map_func: (nullable): map function or %NULL to not map items
* @user_data: (closure): user data passed to @map_func
* @user_destroy: destroy notifier for @user_data
*
/**
* gtk_map_list_model_set_map_func:
* @self: a `GtkMapListModel`
- * @map_func: (allow-none): map function or %NULL to not map items
+ * @map_func: (nullable): map function or %NULL to not map items
* @user_data: (closure): user data passed to @map_func
* @user_destroy: destroy notifier for @user_data
*
/**
* gtk_map_list_model_set_model: (attributes org.gtk.Method.set_property=model)
* @self: a `GtkMapListModel`
- * @model: (allow-none): The model to be mapped
+ * @model: (nullable): The model to be mapped
*
* Sets the model to be mapped.
*
/**
* gtk_media_controls_new:
- * @stream: (allow-none) (transfer none): a `GtkMediaStream` to manage
+ * @stream: (nullable) (transfer none): a `GtkMediaStream` to manage
*
* Creates a new `GtkMediaControls` managing the @stream passed to it.
*
/**
* gtk_media_file_set_filename:
* @self: a `GtkMediaFile`
- * @filename: (allow-none): name of file to play
+ * @filename: (nullable): name of file to play
*
* Sets the `GtkMediaFile to play the given file.
*
/**
* gtk_media_file_set_resource:
* @self: a `GtkMediaFile`
- * @resource_path: (allow-none): path to resource to play
+ * @resource_path: (nullable): path to resource to play
*
* Sets the `GtkMediaFile to play the given resource.
*
/**
* gtk_media_file_set_file: (attributes org.gtk.Method.set_property=file)
* @self: a `GtkMediaFile`
- * @file: (allow-none): the file to play
+ * @file: (nullable): the file to play
*
* Sets the `GtkMediaFile` to play the given file.
*
/**
* gtk_media_file_set_input_stream: (attributes org.gtk.Method.set_property=input-stream)
* @self: a `GtkMediaFile`
- * @stream: (allow-none): the stream to play from
+ * @stream: (nullable): the stream to play from
*
* Sets the `GtkMediaFile` to play the given stream.
*
/**
* gtk_message_dialog_new:
- * @parent: (allow-none): transient parent, or %NULL for none
+ * @parent: (nullable): transient parent, or %NULL for none
* @flags: flags
* @type: type of message
* @buttons: set of buttons to use
- * @message_format: (allow-none): printf()-style format string, or %NULL
+ * @message_format: (nullable): printf()-style format string, or %NULL
* @...: arguments for @message_format
*
* Creates a new message dialog.
/**
* gtk_message_dialog_new_with_markup:
- * @parent: (allow-none): transient parent, or %NULL for none
+ * @parent: (nullable): transient parent, or %NULL for none
* @flags: flags
* @type: type of message
* @buttons: set of buttons to use
- * @message_format: (allow-none): printf()-style format string, or %NULL
+ * @message_format: (nullable): printf()-style format string, or %NULL
* @...: arguments for @message_format
*
* Creates a new message dialog.
/**
* gtk_message_dialog_format_secondary_text:
* @message_dialog: a `GtkMessageDialog`
- * @message_format: (allow-none): printf()-style format string, or %NULL
+ * @message_format: (nullable): printf()-style format string, or %NULL
* @...: arguments for @message_format
*
* Sets the secondary text of the message dialog.
/**
* gtk_mount_operation_new:
- * @parent: (allow-none): transient parent of the window, or %NULL
+ * @parent: (nullable): transient parent of the window, or %NULL
*
* Creates a new `GtkMountOperation`.
*
/**
* gtk_mount_operation_set_parent: (attributes org.gtk.Method.set_property=parent)
* @op: a `GtkMountOperation`
- * @parent: (allow-none): transient parent of the window, or %NULL
+ * @parent: (nullable): transient parent of the window, or %NULL
*
* Sets the transient parent for windows shown by the
* `GtkMountOperation`.
/**
* gtk_multi_selection_new:
- * @model: (allow-none) (transfer full): the `GListModel` to manage, or %NULL
+ * @model: (nullable) (transfer full): the `GListModel` to manage, or %NULL
*
* Creates a new selection to handle @model.
*
/**
* gtk_multi_selection_set_model: (attributes org.gtk.Method.set_property=model)
* @self: a `GtkMultiSelection`
- * @model: (allow-none): A `GListModel` to wrap
+ * @model: (nullable): A `GListModel` to wrap
*
* Sets the model that @self should wrap.
*
/**
* gtk_native_dialog_set_transient_for: (attributes org.gtk.Method.set_property=transient-for)
* @self: a `GtkNativeDialog`
- * @parent: (allow-none): parent window, or %NULL
+ * @parent: (nullable): parent window, or %NULL
*
* Dialog windows should be set transient for the main application
* window they were spawned from.
/**
* gtk_no_selection_new:
- * @model: (allow-none) (transfer full): the `GListModel` to manage, or %NULL
+ * @model: (nullable) (transfer full): the `GListModel` to manage, or %NULL
*
* Creates a new selection to handle @model.
*
/**
* gtk_no_selection_set_model: (attributes org.gtk.Method.set_property=model)
* @self: a `GtkNoSelection`
- * @model: (allow-none): A `GListModel` to wrap
+ * @model: (nullable): A `GListModel` to wrap
*
* Sets the model that @self should wrap.
*
* gtk_notebook_append_page:
* @notebook: a `GtkNotebook`
* @child: the `GtkWidget` to use as the contents of the page
- * @tab_label: (allow-none): the `GtkWidget` to be used as the label
+ * @tab_label: (nullable): the `GtkWidget` to be used as the label
* for the page, or %NULL to use the default label, “page N”
*
* Appends a page to @notebook.
* gtk_notebook_append_page_menu:
* @notebook: a `GtkNotebook`
* @child: the `GtkWidget` to use as the contents of the page
- * @tab_label: (allow-none): the `GtkWidget` to be used as the label
+ * @tab_label: (nullable): the `GtkWidget` to be used as the label
* for the page, or %NULL to use the default label, “page N”
- * @menu_label: (allow-none): the widget to use as a label for the
+ * @menu_label: (nullable): the widget to use as a label for the
* page-switch menu, if that is enabled. If %NULL, and @tab_label
* is a #GtkLabel or %NULL, then the menu label will be a newly
* created label with the same text as @tab_label; if @tab_label
* gtk_notebook_prepend_page:
* @notebook: a `GtkNotebook`
* @child: the `GtkWidget` to use as the contents of the page
- * @tab_label: (allow-none): the #GtkWidget to be used as the label
+ * @tab_label: (nullable): the #GtkWidget to be used as the label
* for the page, or %NULL to use the default label, “page N”
*
* Prepends a page to @notebook.
* gtk_notebook_prepend_page_menu:
* @notebook: a `GtkNotebook`
* @child: the `GtkWidget` to use as the contents of the page
- * @tab_label: (allow-none): the `GtkWidget` to be used as the label
+ * @tab_label: (nullable): the `GtkWidget` to be used as the label
* for the page, or %NULL to use the default label, “page N”
- * @menu_label: (allow-none): the widget to use as a label for the
+ * @menu_label: (nullable): the widget to use as a label for the
* page-switch menu, if that is enabled. If %NULL, and @tab_label
* is a #GtkLabel or %NULL, then the menu label will be a newly
* created label with the same text as @tab_label; if @tab_label
* gtk_notebook_insert_page:
* @notebook: a `GtkNotebook`
* @child: the `GtkWidget` to use as the contents of the page
- * @tab_label: (allow-none): the `GtkWidget` to be used as the label
+ * @tab_label: (nullable): the `GtkWidget` to be used as the label
* for the page, or %NULL to use the default label, “page N”
* @position: the index (starting at 0) at which to insert the page,
* or -1 to append the page after all other pages
* gtk_notebook_insert_page_menu:
* @notebook: a `GtkNotebook`
* @child: the `GtkWidget` to use as the contents of the page
- * @tab_label: (allow-none): the `GtkWidget` to be used as the label
+ * @tab_label: (nullable): the `GtkWidget` to be used as the label
* for the page, or %NULL to use the default label, “page N”
- * @menu_label: (allow-none): the widget to use as a label for the
+ * @menu_label: (nullable): the widget to use as a label for the
* page-switch menu, if that is enabled. If %NULL, and @tab_label
* is a #GtkLabel or %NULL, then the menu label will be a newly
* created label with the same text as @tab_label; if @tab_label
* gtk_notebook_set_tab_label:
* @notebook: a `GtkNotebook`
* @child: the page
- * @tab_label: (allow-none): the tab label widget to use, or %NULL
+ * @tab_label: (nullable): the tab label widget to use, or %NULL
* for default tab label
*
* Changes the tab label for @child.
* gtk_notebook_set_menu_label:
* @notebook: a `GtkNotebook`
* @child: the child widget
- * @menu_label: (allow-none): the menu label, or %NULL for default
+ * @menu_label: (nullable): the menu label, or %NULL for default
*
* Changes the menu label for the page containing @child.
*/
/**
* gtk_notebook_set_group_name: (attributes org.gtk.Method.set_property=group-name)
* @notebook: a `GtkNotebook`
- * @group_name: (allow-none): the name of the notebook group,
+ * @group_name: (nullable): the name of the notebook group,
* or %NULL to unset it
*
* Sets a group name for @notebook.
/**
* gtk_overlay_set_child:
* @overlay: a `GtkOverlay`
- * @child: (allow-none): the child widget
+ * @child: (nullable): the child widget
*
* Sets the child widget of @overlay.
*/
* gtk_page_setup_load_file:
* @setup: a `GtkPageSetup`
* @file_name: (type filename): the filename to read the page setup from
- * @error: (allow-none): return location for an error, or %NULL
+ * @error: (nullable): return location for an error, or %NULL
*
* Reads the page setup from the file @file_name.
*
/**
* gtk_page_setup_new_from_file:
* @file_name: (type filename): the filename to read the page setup from
- * @error: (allow-none): return location for an error, or %NULL
+ * @error: (nullable): return location for an error, or %NULL
*
* Reads the page setup from the file @file_name.
*
* gtk_page_setup_load_key_file:
* @setup: a `GtkPageSetup`
* @key_file: the `GKeyFile` to retrieve the page_setup from
- * @group_name: (allow-none): the name of the group in the key_file to read, or %NULL
+ * @group_name: (nullable): the name of the group in the key_file to read, or %NULL
* to use the default name “Page Setup”
- * @error: (allow-none): return location for an error, or %NULL
+ * @error: (nullable): return location for an error, or %NULL
*
* Reads the page setup from the group @group_name in the key file
* @key_file.
/**
* gtk_page_setup_new_from_key_file:
* @key_file: the `GKeyFile` to retrieve the page_setup from
- * @group_name: (allow-none): the name of the group in the key_file to read, or %NULL
+ * @group_name: (nullable): the name of the group in the key_file to read, or %NULL
* to use the default name “Page Setup”
- * @error: (allow-none): return location for an error, or %NULL
+ * @error: (nullable): return location for an error, or %NULL
*
* Reads the page setup from the group @group_name in the key file
* @key_file.
* gtk_page_setup_to_file:
* @setup: a `GtkPageSetup`
* @file_name: (type filename): the file to save to
- * @error: (allow-none): return location for errors, or %NULL
+ * @error: (nullable): return location for errors, or %NULL
*
* This function saves the information from @setup to @file_name.
*
/**
* gtk_page_setup_unix_dialog_new:
- * @title: (allow-none): the title of the dialog, or %NULL
- * @parent: (allow-none): transient parent of the dialog, or %NULL
+ * @title: (nullable): the title of the dialog, or %NULL
+ * @parent: (nullable): transient parent of the dialog, or %NULL
*
* Creates a new page setup dialog.
*
/**
* gtk_paper_size_new:
- * @name: (allow-none): a paper size name, or %NULL
+ * @name: (nullable): a paper size name, or %NULL
*
* Creates a new `GtkPaperSize` object by parsing a
* [PWG 5101.1-2002](ftp://ftp.pwg.org/pub/pwg/candidates/cs-pwgmsn10-20020226-5101.1.pdf)
* @key_file: the `GKeyFile` to retrieve the papersize from
* @group_name: (nullable): the name of the group in the key file to read,
* or %NULL to read the first group
- * @error: (allow-none): return location for an error, or %NULL
+ * @error: (nullable): return location for an error, or %NULL
*
* Reads a paper size from the group @group_name in the key file
* @key_file.
/**
* gtk_password_entry_set_extra_menu: (attributes org.gtk.Method.set_property=extra-menu)
* @entry: a `GtkPasswordEntry`
- * @model: (allow-none): a `GMenuModel`
+ * @model: (nullable): a `GMenuModel`
*
* Sets a menu model to add when constructing
* the context menu for @entry.
/**
* gtk_popover_set_child: (attributes org.gtk.Method.set_property=child)
* @popover: a `GtkPopover`
- * @child: (allow-none): the child widget
+ * @child: (nullable): the child widget
*
* Sets the child widget of @popover.
*/
/**
* gtk_popover_set_default_widget: (attributes org.gtk.Method.set_property=default-widget)
* @popover: a `GtkPopover`
- * @widget: (allow-none): a child widget of @popover to set as
+ * @widget: (nullable): a child widget of @popover to set as
* the default, or %NULL to unset the default widget for the popover
*
* Sets the default widget of a `GtkPopover`.
/**
* gtk_popover_menu_new_from_model:
- * @model: (allow-none): a `GMenuModel`, or %NULL
+ * @model: (nullable): a `GMenuModel`, or %NULL
*
* Creates a `GtkPopoverMenu` and populates it according to @model.
*
/**
* gtk_popover_menu_bar_new_from_model:
- * @model: (allow-none): a `GMenuModel`, or %NULL
+ * @model: (nullable): a `GMenuModel`, or %NULL
*
* Creates a `GtkPopoverMenuBar` from a `GMenuModel`.
*
/**
* gtk_popover_menu_bar_set_menu_model: (attributes org.gtk.Method.set_property=menu-model)
* @bar: a `GtkPopoverMenuBar`
- * @model: (allow-none): a `GMenuModel`, or %NULL
+ * @model: (nullable): a `GMenuModel`, or %NULL
*
* Sets a menu model from which @bar should take
* its contents.
/**
* gtk_print_job_get_surface:
* @job: a `GtkPrintJob`
- * @error: (allow-none): return location for errors, or %NULL
+ * @error: (nullable): return location for errors, or %NULL
*
* Gets a cairo surface onto which the pages of
* the print job should be rendered.
/**
* gtk_print_run_page_setup_dialog:
- * @parent: (allow-none): transient parent
- * @page_setup: (allow-none): an existing #GtkPageSetup
+ * @parent: (nullable): transient parent
+ * @page_setup: (nullable): an existing #GtkPageSetup
* @settings: a #GtkPrintSettings
*
* Runs a page setup dialog, letting the user modify the values from
/**
* gtk_print_run_page_setup_dialog_async:
- * @parent: (allow-none): transient parent, or %NULL
- * @page_setup: (allow-none): an existing #GtkPageSetup, or %NULL
+ * @parent: (nullable): transient parent, or %NULL
+ * @page_setup: (nullable): an existing #GtkPageSetup, or %NULL
* @settings: a #GtkPrintSettings
* @done_cb: (scope async): a function to call when the user saves
* the modified page setup
* @operation: the `GtkPrintOperation` on which the signal was emitted
* @preview: the `GtkPrintOperationPreview` for the current operation
* @context: the `GtkPrintContext` that will be used
- * @parent: (allow-none): the `GtkWindow` to use as window parent, or %NULL
+ * @parent: (nullable): the `GtkWindow` to use as window parent, or %NULL
*
* Gets emitted when a preview is requested from the native dialog.
*
/**
* gtk_print_operation_set_default_page_setup: (attributes org.gtk.Method.set_property=default-page-setup)
* @op: a `GtkPrintOperation`
- * @default_page_setup: (allow-none): a `GtkPageSetup`, or %NULL
+ * @default_page_setup: (nullable): a `GtkPageSetup`, or %NULL
*
* Makes @default_page_setup the default page setup for @op.
*
/**
* gtk_print_operation_set_print_settings: (attributes org.gtk.Method.set_property=print-settings)
* @op: a `GtkPrintOperation`
- * @print_settings: (allow-none): `GtkPrintSettings`
+ * @print_settings: (nullable): `GtkPrintSettings`
*
* Sets the print settings for @op.
*
/**
* gtk_print_operation_set_custom_tab_label: (attributes org.gtk.Method.set_property=custom-tab-label)
* @op: a `GtkPrintOperation`
- * @label: (allow-none): the label to use, or %NULL to use the default label
+ * @label: (nullable): the label to use, or %NULL to use the default label
*
* Sets the label for the tab holding custom widgets.
*/
* gtk_print_operation_run:
* @op: a `GtkPrintOperation`
* @action: the action to start
- * @parent: (allow-none): Transient parent of the dialog
- * @error: (allow-none): Return location for errors, or %NULL
+ * @parent: (nullable): Transient parent of the dialog
+ * @error: (nullable): Return location for errors, or %NULL
*
* Runs the print operation.
*
* gtk_print_settings_set:
* @settings: a `GtkPrintSettings`
* @key: a key
- * @value: (allow-none): a string value, or %NULL
+ * @value: (nullable): a string value, or %NULL
*
* Associates @value with @key.
*/
* gtk_print_settings_load_file:
* @settings: a `GtkPrintSettings`
* @file_name: (type filename): the filename to read the settings from
- * @error: (allow-none): return location for errors, or %NULL
+ * @error: (nullable): return location for errors, or %NULL
*
* Reads the print settings from @file_name.
*
/**
* gtk_print_settings_new_from_file:
* @file_name: (type filename): the filename to read the settings from
- * @error: (allow-none): return location for errors, or %NULL
+ * @error: (nullable): return location for errors, or %NULL
*
* Reads the print settings from @file_name.
*
* gtk_print_settings_load_key_file:
* @settings: a `GtkPrintSettings`
* @key_file: the `GKeyFile` to retrieve the settings from
- * @group_name: (allow-none): the name of the group to use, or %NULL
+ * @group_name: (nullable): the name of the group to use, or %NULL
* to use the default “Print Settings”
- * @error: (allow-none): return location for errors, or %NULL
+ * @error: (nullable): return location for errors, or %NULL
*
* Reads the print settings from the group @group_name in @key_file.
*
/**
* gtk_print_settings_new_from_key_file:
* @key_file: the `GKeyFile` to retrieve the settings from
- * @group_name: (allow-none): the name of the group to use, or %NULL to use
+ * @group_name: (nullable): the name of the group to use, or %NULL to use
* the default “Print Settings”
- * @error: (allow-none): return location for errors, or %NULL
+ * @error: (nullable): return location for errors, or %NULL
*
* Reads the print settings from the group @group_name in @key_file.
*
* gtk_print_settings_to_file:
* @settings: a `GtkPrintSettings`
* @file_name: (type filename): the file to save to
- * @error: (allow-none): return location for errors, or %NULL
+ * @error: (nullable): return location for errors, or %NULL
*
* This function saves the print settings from @settings to @file_name.
*
/**
* gtk_print_unix_dialog_new:
- * @title: (allow-none): Title of the dialog, or %NULL
- * @parent: (allow-none): Transient parent of the dialog, or %NULL
+ * @title: (nullable): Title of the dialog, or %NULL
+ * @parent: (nullable): Transient parent of the dialog, or %NULL
*
* Creates a new `GtkPrintUnixDialog`.
*
/**
* gtk_print_unix_dialog_set_settings: (attributes org.gtk.Method.set_property=print-settings)
* @dialog: a `GtkPrintUnixDialog`
- * @settings: (allow-none): a `GtkPrintSettings`, or %NULL
+ * @settings: (nullable): a `GtkPrintSettings`, or %NULL
*
* Sets the `GtkPrintSettings` for the `GtkPrintUnixDialog`.
*
/**
* gtk_progress_bar_set_text: (attributes org.gtk.Method.set_property=text)
* @pbar: a `GtkProgressBar`
- * @text: (allow-none): a UTF-8 string, or %NULL
+ * @text: (nullable): a UTF-8 string, or %NULL
*
* Causes the given @text to appear next to the progress bar.
*
/**
* gtk_range_get_slider_range:
* @range: a `GtkRange`
- * @slider_start: (out) (allow-none): return location for the slider's start
- * @slider_end: (out) (allow-none): return location for the slider's end
+ * @slider_start: (out) (optional): return location for the slider's start
+ * @slider_end: (out) (optional): return location for the slider's end
*
* This function returns sliders range along the long dimension,
* in widget->window coordinates.
* gtk_recent_manager_remove_item:
* @manager: a `GtkRecentManager`
* @uri: the URI of the item you wish to remove
- * @error: (allow-none): return location for a #GError, or %NULL
+ * @error: (nullable): return location for a #GError, or %NULL
*
* Removes a resource pointed by @uri from the recently used resources
* list handled by a recent manager.
* gtk_recent_manager_lookup_item:
* @manager: a `GtkRecentManager`
* @uri: a URI
- * @error: (allow-none): a return location for a #GError, or %NULL
+ * @error: (nullable): a return location for a #GError, or %NULL
*
* Searches for a URI inside the recently used resources list, and
* returns a `GtkRecentInfo` containing information about the resource
* gtk_recent_manager_move_item:
* @manager: a `GtkRecentManager`
* @uri: the URI of a recently used resource
- * @new_uri: (allow-none): the new URI of the recently used resource, or
+ * @new_uri: (nullable): the new URI of the recently used resource, or
* %NULL to remove the item pointed by @uri in the list
- * @error: (allow-none): a return location for a #GError, or %NULL
+ * @error: (nullable): a return location for a #GError, or %NULL
*
* Changes the location of a recently used resource from @uri to @new_uri.
*
/**
* gtk_recent_manager_purge_items:
* @manager: a `GtkRecentManager`
- * @error: (allow-none): a return location for a #GError, or %NULL
+ * @error: (nullable): a return location for a #GError, or %NULL
*
* Purges every item from the recently used resources list.
*
/**
* gtk_recent_info_get_applications:
* @info: a `GtkRecentInfo`
- * @length: (out) (allow-none): return location for the length of the returned list
+ * @length: (out) (optional): return location for the length of the returned list
*
* Retrieves the list of applications that have registered this resource.
*
/**
* gtk_recent_info_get_groups:
* @info: a `GtkRecentInfo`
- * @length: (out) (allow-none): return location for the number of groups returned
+ * @length: (out) (optional): return location for the number of groups returned
*
* Returns all groups registered for the recently used item @info.
*
/**
* gtk_recent_info_create_app_info:
* @info: a `GtkRecentInfo`
- * @app_name: (allow-none): the name of the application that should
+ * @app_name: (nullable): the name of the application that should
* be mapped to a `GAppInfo`; if %NULL is used then the default
* application for the MIME type is used
- * @error: (allow-none): return location for a #GError, or %NULL
+ * @error: (nullable): return location for a #GError, or %NULL
*
* Creates a `GAppInfo` for the specified `GtkRecentInfo`
*
/**
* gtk_revealer_set_child: (attributes org.gtk.Method.set_property=child)
* @revealer: a `GtkRevealer`
- * @child: (allow-none): the child widget
+ * @child: (nullable): the child widget
*
* Sets the child widget of @revealer.
*/
/**
* gtk_root_set_focus:
* @self: a `GtkRoot`
- * @focus: (allow-none): widget to be the new focus widget, or %NULL
+ * @focus: (nullable): widget to be the new focus widget, or %NULL
* to unset the focus widget
*
* If @focus is not the current focus widget, and is focusable, sets
/**
* gtk_scale_get_layout_offsets:
* @scale: a #GtkScale
- * @x: (out) (allow-none): location to store X offset of layout, or %NULL
- * @y: (out) (allow-none): location to store Y offset of layout, or %NULL
+ * @x: (out) (optional): location to store X offset of layout, or %NULL
+ * @y: (out) (optional): location to store Y offset of layout, or %NULL
*
* Obtains the coordinates where the scale will draw the
* `PangoLayout` representing the text in the scale.
* and %GTK_POS_LEFT are drawn above the scale, anything else below.
* For a vertical scale, #GTK_POS_LEFT and %GTK_POS_TOP are drawn to
* the left of the scale, anything else to the right.
- * @markup: (allow-none): Text to be shown at the mark, using
+ * @markup: (nullable): Text to be shown at the mark, using
* Pango markup, or %NULL
*
* Adds a mark at @value.
* @max: the maximum value of the scale (usually 100)
* @step: the stepping of value when a scroll-wheel event,
* or up/down arrow event occurs (usually 2)
- * @icons: (allow-none) (array zero-terminated=1): a %NULL-terminated
+ * @icons: (nullable) (array zero-terminated=1): a %NULL-terminated
* array of icon names, or %NULL if you want to set the list
* later with gtk_scale_button_set_icons()
*
/**
* gtk_scrollable_set_hadjustment: (attributes org.gtk.Method.set_property=hadjustment)
* @scrollable: a `GtkScrollable`
- * @hadjustment: (allow-none): a `GtkAdjustment`
+ * @hadjustment: (nullable): a `GtkAdjustment`
*
* Sets the horizontal adjustment of the `GtkScrollable`.
*/
/**
* gtk_scrollable_set_vadjustment: (attributes org.gtk.Method.set_property=vadjustment)
* @scrollable: a `GtkScrollable`
- * @vadjustment: (allow-none): a `GtkAdjustment`
+ * @vadjustment: (nullable): a `GtkAdjustment`
*
* Sets the vertical adjustment of the `GtkScrollable`.
*/
/**
* gtk_scrollbar_new:
* @orientation: the scrollbar’s orientation.
- * @adjustment: (allow-none): the [class@Gtk.Adjustment] to use, or %NULL
+ * @adjustment: (nullable): the [class@Gtk.Adjustment] to use, or %NULL
* to create a new adjustment.
*
* Creates a new scrollbar with the given orientation.
/**
* gtk_scrolled_window_set_child: (attributes org.gtk.Method.set_property=child)
* @scrolled_window: a `GtkScrolledWindow`
- * @child: (allow-none): the child widget
+ * @child: (nullable): the child widget
*
* Sets the child widget of @scrolled_window.
*/
/**
* gtk_search_bar_set_child: (attributes org.gtk.Method.set_property=child)
* @bar: a `GtkSearchBar`
- * @child: (allow-none): the child widget
+ * @child: (nullable): the child widget
*
* Sets the child widget of @bar.
*/
/**
* gtk_selection_filter_model_new:
- * @model: (allow-none) (transfer none): the selection model to filter, or %NULL
+ * @model: (nullable) (transfer none): the selection model to filter, or %NULL
*
* Creates a new `GtkSelectionFilterModel` that will include the
* selected items from the underlying selection model.
/**
* gtk_selection_filter_model_set_model: (attributes org.gtk.Method.set_property=model)
* @self: a `GtkSelectionFilterModel`
- * @model: (allow-none): The model to be filtered
+ * @model: (nullable): The model to be filtered
*
* Sets the model to be filtered.
*
* @trigger: (transfer full) (nullable): The trigger that will trigger the shortcut
* @action: (transfer full) (nullable): The action that will be activated upon
* triggering
- * @format_string: (allow-none): GVariant format string for arguments or %NULL for
+ * @format_string: (nullable): GVariant format string for arguments or %NULL for
* no arguments
* @...: arguments, as given by format string.
*
* @self: a `GtkShortcutAction`
* @flags: flags to activate with
* @widget: Target of the activation
- * @args: (allow-none): arguments to pass
+ * @args: (nullable): arguments to pass
*
* Activates the action on the @widget with the given @args.
*
/**
* gtk_show_uri:
- * @parent: (allow-none): parent window
+ * @parent: (nullable): parent window
* @uri: the uri to show
* @timestamp: timestamp from the event that triggered this call, or %GDK_CURRENT_TIME
*
/**
* gtk_single_selection_new:
- * @model: (allow-none) (transfer full): the `GListModel` to manage, or %NULL
+ * @model: (nullable) (transfer full): the `GListModel` to manage, or %NULL
*
* Creates a new selection to handle @model.
*
/**
* gtk_single_selection_set_model: (attributes org.gtk.Method.set_property=model)
* @self: a `GtkSingleSelection`
- * @model: (allow-none): A `GListModel` to wrap
+ * @model: (nullable): A `GListModel` to wrap
*
* Sets the model that @self should wrap.
*
/**
* gtk_widget_get_preferred_size:
* @widget: a `GtkWidget` instance
- * @minimum_size: (out) (allow-none): location for storing the minimum size, or %NULL
- * @natural_size: (out) (allow-none): location for storing the natural size, or %NULL
+ * @minimum_size: (out) (optional): location for storing the minimum size, or %NULL
+ * @natural_size: (out) (optional): location for storing the natural size, or %NULL
*
* Retrieves the minimum and natural size of a widget, taking
* into account the widget’s preference for height-for-width management.
/**
* gtk_slice_list_model_new:
- * @model: (transfer full) (allow-none): The model to use, or %NULL
+ * @model: (transfer full) (nullable): The model to use, or %NULL
* @offset: the offset of the slice
* @size: maximum size of the slice
*
/**
* gtk_slice_list_model_set_model: (attributes org.gtk.Method.set_property=model)
* @self: a `GtkSliceListModel`
- * @model: (allow-none): The model to be sliced
+ * @model: (nullable): The model to be sliced
*
* Sets the model to show a slice of.
*
/**
* gtk_snapshot_free_to_paintable: (skip)
* @snapshot: (transfer full): a `GtkSnapshot`
- * @size: (allow-none): The size of the resulting paintable
+ * @size: (nullable): The size of the resulting paintable
* or %NULL to use the bounds of the snapshot
*
* Returns a paintable for the node that was
/**
* gtk_snapshot_to_paintable:
* @snapshot: a `GtkSnapshot`
- * @size: (allow-none): The size of the resulting paintable
+ * @size: (nullable): The size of the resulting paintable
* or %NULL to use the bounds of the snapshot
*
* Returns a paintable encapsulating the render node
/**
* gtk_snapshot_transform:
* @snapshot: a `GtkSnapshot`
- * @transform: (allow-none): the transform to apply
+ * @transform: (nullable): the transform to apply
*
* Transforms @snapshot's coordinate system with the given @transform.
*/
/**
* gtk_sort_list_model_new:
- * @model: (allow-none) (transfer full): the model to sort, or %NULL
- * @sorter: (allow-none) (transfer full): the `GtkSorter` to sort @model with, or %NULL
+ * @model: (nullable) (transfer full): the model to sort, or %NULL
+ * @sorter: (nullable) (transfer full): the `GtkSorter` to sort @model with, or %NULL
*
* Creates a new sort list model that uses the @sorter to sort @model.
*
/**
* gtk_sort_list_model_set_model: (attributes org.gtk.Method.set_property=model)
* @self: a `GtkSortListModel`
- * @model: (allow-none): The model to be sorted
+ * @model: (nullable): The model to be sorted
*
* Sets the model to be sorted.
*
/**
* gtk_sort_list_model_set_sorter: (attributes org.gtk.Method.set_property=sorter)
* @self: a `GtkSortListModel`
- * @sorter: (allow-none): the `GtkSorter` to sort @model with
+ * @sorter: (nullable): the `GtkSorter` to sort @model with
*
* Sets a new sorter on @self.
*/
/**
* gtk_spin_button_new:
- * @adjustment: (allow-none): the `GtkAdjustment` that this spin
+ * @adjustment: (nullable): the `GtkAdjustment` that this spin
* button should use, or %NULL
* @climb_rate: specifies by how much the rate of change in the value will
* accelerate if you continue to hold down an up/down button or arrow key
/**
* gtk_spin_button_get_increments:
* @spin_button: a `GtkSpinButton`
- * @step: (out) (allow-none): location to store step increment, or %NULL
- * @page: (out) (allow-none): location to store page increment, or %NULL
+ * @step: (out) (optional): location to store step increment, or %NULL
+ * @page: (out) (optional): location to store page increment, or %NULL
*
* Gets the current step and page the increments
* used by @spin_button.
/**
* gtk_stack_switcher_set_stack: (attributes org.gtk.Method.set_property=stack)
* @switcher: a `GtkStackSwitcher`
- * @stack: (allow-none): a `GtkStack`
+ * @stack: (nullable): a `GtkStack`
*
* Sets the stack to control.
*/
/**
* gtk_text_set_extra_menu: (attributes org.gtk.Method.set_property=extra-menu)
* @self: a `GtkText`
- * @model: (allow-none): a `GMenuModel`
+ * @model: (nullable): a `GMenuModel`
*
* Sets a menu model to add when constructing
* the context menu for @self.
/**
* gtk_text_buffer_new:
- * @table: (allow-none): a tag table, or %NULL to create a new one
+ * @table: (nullable): a tag table, or %NULL to create a new one
*
* Creates a new text buffer.
*
/**
* gtk_text_buffer_create_mark:
* @buffer: a `GtkTextBuffer`
- * @mark_name: (allow-none): name for mark, or %NULL
+ * @mark_name: (nullable): name for mark, or %NULL
* @where: location to place mark
* @left_gravity: whether the mark has left gravity
*
/**
* gtk_text_buffer_create_tag:
* @buffer: a `GtkTextBuffer`
- * @tag_name: (allow-none): name of the new tag, or %NULL
- * @first_property_name: (allow-none): name of first property to set, or %NULL
+ * @tag_name: (nullable): name of the new tag, or %NULL
+ * @first_property_name: (nullable): name of first property to set, or %NULL
* @...: %NULL-terminated list of property names and values
*
* Creates a tag and adds it to the tag table for @buffer.
* gtk_text_buffer_paste_clipboard:
* @buffer: a `GtkTextBuffer`
* @clipboard: the `GdkClipboard` to paste from
- * @override_location: (allow-none): location to insert pasted text, or %NULL
+ * @override_location: (nullable): location to insert pasted text, or %NULL
* @default_editable: whether the buffer is editable by default
*
* Pastes the contents of a clipboard.
/**
* gtk_text_iter_ends_tag:
* @iter: an iterator
- * @tag: (allow-none): a `GtkTextTag`, or %NULL
+ * @tag: (nullable): a `GtkTextTag`, or %NULL
*
* Returns %TRUE if @tag is toggled off at exactly this point.
*
/**
* gtk_text_iter_toggles_tag:
* @iter: an iterator
- * @tag: (allow-none): a `GtkTextTag`, or %NULL
+ * @tag: (nullable): a `GtkTextTag`, or %NULL
*
* Gets whether a range with @tag applied to it begins
* or ends at @iter.
/**
* gtk_text_iter_forward_to_tag_toggle:
* @iter: a `GtkTextIter`
- * @tag: (allow-none): a `GtkTextTag`, or %NULL
+ * @tag: (nullable): a `GtkTextTag`, or %NULL
*
* Moves forward to the next toggle (on or off) of the
* @tag, or to the next toggle of any tag if
/**
* gtk_text_iter_backward_to_tag_toggle:
* @iter: a `GtkTextIter`
- * @tag: (allow-none): a `GtkTextTag`, or %NULL
+ * @tag: (nullable): a `GtkTextTag`, or %NULL
*
* Moves backward to the next toggle (on or off) of the
* @tag, or to the next toggle of any tag if
* @iter: a `GtkTextIter`
* @pred: (scope call): a function to be called on each character
* @user_data: (closure): user data for @pred
- * @limit: (allow-none): search limit, or %NULL for none
+ * @limit: (nullable): search limit, or %NULL for none
*
* Advances @iter, calling @pred on each character.
*
* @iter: a `GtkTextIter`
* @pred: (scope call): function to be called on each character
* @user_data: (closure): user data for @pred
- * @limit: (allow-none): search limit, or %NULL for none
+ * @limit: (nullable): search limit, or %NULL for none
*
* Same as gtk_text_iter_forward_find_char(),
* but goes backward from @iter.
* @iter: start of search
* @str: a search string
* @flags: flags affecting how the search is done
- * @match_start: (out caller-allocates) (allow-none): return location for start of match, or %NULL
- * @match_end: (out caller-allocates) (allow-none): return location for end of match, or %NULL
- * @limit: (allow-none): location of last possible @match_end, or %NULL for the end of the buffer
+ * @match_start: (out caller-allocates) (optional): return location for start of match, or %NULL
+ * @match_end: (out caller-allocates) (optional): return location for end of match, or %NULL
+ * @limit: (nullable): location of last possible @match_end, or %NULL for the end of the buffer
*
* Searches forward for @str.
*
* @iter: a `GtkTextIter` where the search begins
* @str: search string
* @flags: bitmask of flags affecting the search
- * @match_start: (out caller-allocates) (allow-none): return location for start of match, or %NULL
- * @match_end: (out caller-allocates) (allow-none): return location for end of match, or %NULL
- * @limit: (allow-none): location of last possible @match_start, or %NULL for start of buffer
+ * @match_start: (out caller-allocates) (optional): return location for start of match, or %NULL
+ * @match_end: (out caller-allocates) (optional): return location for end of match, or %NULL
+ * @limit: (nullable): location of last possible @match_start, or %NULL for start of buffer
*
* Same as gtk_text_iter_forward_search(), but moves backward.
*
/*
* gtk_text_layout_set_buffer:
- * @buffer: (allow-none):
+ * @buffer: (nullable):
*/
void
gtk_text_layout_set_buffer (GtkTextLayout *layout,
/**
* gtk_text_mark_new:
- * @name: (allow-none): mark name or %NULL
+ * @name: (nullable): mark name or %NULL
* @left_gravity: whether the mark should have left gravity
*
* Creates a text mark.
/**
* gtk_text_tag_new:
- * @name: (allow-none): tag name, or %NULL
+ * @name: (nullable): tag name, or %NULL
*
* Creates a `GtkTextTag`.
*
/**
* gtk_text_view_set_buffer: (attributes org.gtk.Method.set_property=buffer)
* @text_view: a `GtkTextView`
- * @buffer: (allow-none): a `GtkTextBuffer`
+ * @buffer: (nullable): a `GtkTextBuffer`
*
* Sets @buffer as the buffer being displayed by @text_view.
*
/**
* gtk_text_view_get_cursor_locations:
* @text_view: a `GtkTextView`
- * @iter: (allow-none): a `GtkTextIter`
- * @strong: (out) (allow-none): location to store the strong cursor position
- * @weak: (out) (allow-none): location to store the weak cursor position
+ * @iter: (nullable): a `GtkTextIter`
+ * @strong: (out) (optional): location to store the strong cursor position
+ * @weak: (out) (optional): location to store the weak cursor position
*
* Determine the positions of the strong and weak cursors if the
* insertion point is at @iter.
* gtk_text_view_get_iter_at_position:
* @text_view: a `GtkTextView`
* @iter: (out): a `GtkTextIter`
- * @trailing: (out) (allow-none): if non-%NULL, location to store
+ * @trailing: (out) (optional): if non-%NULL, location to store
* an integer indicating where in the grapheme the user clicked.
* It will either be zero, or the number of characters in the grapheme.
* 0 represents the trailing edge of the grapheme.
* @win: a #GtkTextWindowType
* @buffer_x: buffer x coordinate
* @buffer_y: buffer y coordinate
- * @window_x: (out) (allow-none): window x coordinate return location or %NULL
- * @window_y: (out) (allow-none): window y coordinate return location or %NULL
+ * @window_x: (out) (optional): window x coordinate return location or %NULL
+ * @window_y: (out) (optional): window y coordinate return location or %NULL
*
* Converts buffer coordinates to window coordinates.
*/
* @win: a #GtkTextWindowType
* @window_x: window x coordinate
* @window_y: window y coordinate
- * @buffer_x: (out) (allow-none): buffer x coordinate return location or %NULL
- * @buffer_y: (out) (allow-none): buffer y coordinate return location or %NULL
+ * @buffer_x: (out) (optional): buffer x coordinate return location or %NULL
+ * @buffer_y: (out) (optional): buffer y coordinate return location or %NULL
*
* Converts coordinates on the window identified by @win to buffer
* coordinates.
/**
* gtk_text_view_set_extra_menu: (attributes org.gtk.Method.set_property=extra-menu)
* @text_view: a `GtkTextView`
- * @model: (allow-none): a `GMenuModel`
+ * @model: (nullable): a `GMenuModel`
*
* Sets a menu model to add when constructing the context
* menu for @text_view.
/**
* gtk_tooltip_set_markup:
* @tooltip: a `GtkTooltip`
- * @markup: (allow-none): a string with Pango markup or %NLL
+ * @markup: (nullable): a string with Pango markup or %NLL
*
* Sets the text of the tooltip to be @markup.
*
/**
* gtk_tooltip_set_text:
* @tooltip: a `GtkTooltip`
- * @text: (allow-none): a text string or %NULL
+ * @text: (nullable): a text string or %NULL
*
* Sets the text of the tooltip to be @text.
*
/**
* gtk_tooltip_set_icon:
* @tooltip: a #GtkTooltip
- * @paintable: (allow-none): a #GdkPaintable, or %NULL
+ * @paintable: (nullable): a #GdkPaintable, or %NULL
*
* Sets the icon of the tooltip (which is in front of the text) to be
* @paintable. If @paintable is %NULL, the image will be hidden.
/**
* gtk_tooltip_set_icon_from_icon_name:
* @tooltip: a #GtkTooltip
- * @icon_name: (allow-none): an icon name, or %NULL
+ * @icon_name: (nullable): an icon name, or %NULL
*
* Sets the icon of the tooltip (which is in front of the text) to be
* the icon indicated by @icon_name with the size indicated
/**
* gtk_tooltip_set_icon_from_gicon:
* @tooltip: a #GtkTooltip
- * @gicon: (allow-none): a #GIcon representing the icon, or %NULL
+ * @gicon: (nullable): a #GIcon representing the icon, or %NULL
*
* Sets the icon of the tooltip (which is in front of the text)
* to be the icon indicated by @gicon with the size indicated
/**
* gtk_tooltip_set_custom:
* @tooltip: a #GtkTooltip
- * @custom_widget: (allow-none): a #GtkWidget, or %NULL to unset the old custom widget.
+ * @custom_widget: (nullable): a #GtkWidget, or %NULL to unset the old custom widget.
*
* Replaces the widget packed into the tooltip with
* @custom_widget. @custom_widget does not get destroyed when the tooltip goes
/**
* gtk_tree_path_get_indices_with_depth: (rename-to gtk_tree_path_get_indices)
* @path: a `GtkTreePath`
- * @depth: (out) (allow-none): return location for number of elements
+ * @depth: (out) (optional): return location for number of elements
* returned in the integer array, or %NULL
*
* Returns the current indices of @path.
/**
* gtk_tree_path_free:
- * @path: (allow-none): a #GtkTreePath-struct
+ * @path: (nullable): a #GtkTreePath-struct
*
* Frees @path. If @path is %NULL, it simply returns.
*/
* gtk_tree_model_iter_children:
* @tree_model: a #GtkTreeModel
* @iter: (out): the new #GtkTreeIter-struct to be set to the child
- * @parent: (allow-none): the #GtkTreeIter-struct, or %NULL
+ * @parent: (nullable): the #GtkTreeIter-struct, or %NULL
*
* Sets @iter to point to the first child of @parent.
*
/**
* gtk_tree_model_iter_n_children:
* @tree_model: a #GtkTreeModel
- * @iter: (allow-none): the #GtkTreeIter-struct, or %NULL
+ * @iter: (nullable): the #GtkTreeIter-struct, or %NULL
*
* Returns the number of children that @iter has.
*
* gtk_tree_model_iter_nth_child:
* @tree_model: a #GtkTreeModel
* @iter: (out): the #GtkTreeIter-struct to set to the nth child
- * @parent: (allow-none): the #GtkTreeIter-struct to get the child from, or %NULL.
+ * @parent: (nullable): the #GtkTreeIter-struct to get the child from, or %NULL.
* @n: the index of the desired child
*
* Sets @iter to be the child of @parent, using the given index.
* @tree_model: a `GtkTreeModel`
* @path: a `GtkTreePath` pointing to the tree node whose children
* have been reordered
- * @iter: (allow-none): a valid #GtkTreeIter-struct pointing to the node
+ * @iter: (nullable): a valid #GtkTreeIter-struct pointing to the node
* whose children have been reordered, or %NULL if the depth
* of @path is 0
* @new_order: (array length=length): an array of integers
/**
* gtk_tree_row_reference_valid:
- * @reference: (allow-none): a #GtkTreeRowReference, or %NULL
+ * @reference: (nullable): a #GtkTreeRowReference, or %NULL
*
* Returns %TRUE if the @reference is non-%NULL and refers to
* a current valid path.
/**
* gtk_tree_row_reference_free:
- * @reference: (allow-none): a #GtkTreeRowReference, or %NULL
+ * @reference: (nullable): a #GtkTreeRowReference, or %NULL
*
* Free’s @reference. @reference may be %NULL
*/
/**
* gtk_tree_model_filter_new:
* @child_model: A #GtkTreeModel.
- * @root: (allow-none): A #GtkTreePath or %NULL.
+ * @root: (nullable): A #GtkTreePath or %NULL.
*
* Creates a new #GtkTreeModel, with @child_model as the child_model
* and @root as the virtual root.
* gtk_tree_model_filter_set_visible_func:
* @filter: A #GtkTreeModelFilter
* @func: A #GtkTreeModelFilterVisibleFunc, the visible function
- * @data: (allow-none): User data to pass to the visible function, or %NULL
- * @destroy: (allow-none): Destroy notifier of @data, or %NULL
+ * @data: (nullable): User data to pass to the visible function, or %NULL
+ * @destroy: (nullable): Destroy notifier of @data, or %NULL
*
* Sets the visible function used when filtering the @filter to be @func.
* The function should return %TRUE if the given row should be visible and
* @n_columns: The number of columns in the filter model.
* @types: (array length=n_columns): The #GTypes of the columns.
* @func: A #GtkTreeModelFilterModifyFunc
- * @data: (allow-none): User data to pass to the modify function, or %NULL.
- * @destroy: (allow-none): Destroy notifier of @data, or %NULL.
+ * @data: (nullable): User data to pass to the modify function, or %NULL.
+ * @destroy: (nullable): Destroy notifier of @data, or %NULL.
*
* With the @n_columns and @types parameters, you give an array of column
* types for this model (which will be exposed to the parent model/view).
/**
* gtk_tree_model_sort_set_model:
* @tree_model_sort: The #GtkTreeModelSort.
- * @child_model: (allow-none): A #GtkTreeModel, or %NULL.
+ * @child_model: (nullable): A #GtkTreeModel, or %NULL.
*
* Sets the model of @tree_model_sort to be @model. If @model is %NULL,
* then the old model is unset. The sort function is unset as a result
/**
* gtk_tree_selection_get_selected:
* @selection: A #GtkTreeSelection.
- * @model: (out) (allow-none) (transfer none): A pointer to set to the #GtkTreeModel, or NULL.
- * @iter: (out) (allow-none): The #GtkTreeIter, or NULL.
+ * @model: (out) (optional) (transfer none): A pointer to set to the #GtkTreeModel, or NULL.
+ * @iter: (out) (optional): The #GtkTreeIter, or NULL.
*
* Sets @iter to the currently selected node if @selection is set to
* #GTK_SELECTION_SINGLE or #GTK_SELECTION_BROWSE. @iter may be NULL if you
/**
* gtk_tree_selection_get_selected_rows:
* @selection: A #GtkTreeSelection.
- * @model: (out) (allow-none) (transfer none): A pointer to set to the #GtkTreeModel, or %NULL.
+ * @model: (out) (optional) (transfer none): A pointer to set to the #GtkTreeModel, or %NULL.
*
* Creates a list of path of all selected rows. Additionally, if you are
* planning on modifying the model after calling this function, you may
* @sort_column_id: the sort column id to set the function for
* @sort_func: The comparison function
* @user_data: (closure): User data to pass to @sort_func, or %NULL
- * @destroy: (allow-none): Destroy notifier of @user_data, or %NULL
+ * @destroy: (nullable): Destroy notifier of @user_data, or %NULL
*
* Sets the comparison function used when sorting to be @sort_func. If the
* current sort column id of @sortable is the same as @sort_column_id, then
* @sortable: A #GtkTreeSortable
* @sort_func: The comparison function
* @user_data: (closure): User data to pass to @sort_func, or %NULL
- * @destroy: (allow-none): Destroy notifier of @user_data, or %NULL
+ * @destroy: (nullable): Destroy notifier of @user_data, or %NULL
*
* Sets the default comparison function used when sorting to be @sort_func.
* If the current sort column id of @sortable is
* gtk_tree_store_insert:
* @tree_store: A #GtkTreeStore
* @iter: (out): An unset #GtkTreeIter to set to the new row
- * @parent: (allow-none): A valid #GtkTreeIter, or %NULL
+ * @parent: (nullable): A valid #GtkTreeIter, or %NULL
* @position: position to insert the new row, or -1 for last
*
* Creates a new row at @position. If parent is non-%NULL, then the row will be
* gtk_tree_store_insert_before:
* @tree_store: A #GtkTreeStore
* @iter: (out): An unset #GtkTreeIter to set to the new row
- * @parent: (allow-none): A valid #GtkTreeIter, or %NULL
- * @sibling: (allow-none): A valid #GtkTreeIter, or %NULL
+ * @parent: (nullable): A valid #GtkTreeIter, or %NULL
+ * @sibling: (nullable): A valid #GtkTreeIter, or %NULL
*
* Inserts a new row before @sibling. If @sibling is %NULL, then the row will
* be appended to @parent ’s children. If @parent and @sibling are %NULL, then
* gtk_tree_store_insert_after:
* @tree_store: A #GtkTreeStore
* @iter: (out): An unset #GtkTreeIter to set to the new row
- * @parent: (allow-none): A valid #GtkTreeIter, or %NULL
- * @sibling: (allow-none): A valid #GtkTreeIter, or %NULL
+ * @parent: (nullable): A valid #GtkTreeIter, or %NULL
+ * @sibling: (nullable): A valid #GtkTreeIter, or %NULL
*
* Inserts a new row after @sibling. If @sibling is %NULL, then the row will be
* prepended to @parent ’s children. If @parent and @sibling are %NULL, then
/**
* gtk_tree_store_insert_with_values:
* @tree_store: A #GtkTreeStore
- * @iter: (out) (allow-none): An unset #GtkTreeIter to set the new row, or %NULL.
- * @parent: (allow-none): A valid #GtkTreeIter, or %NULL
+ * @iter: (out) (optional): An unset #GtkTreeIter to set the new row, or %NULL.
+ * @parent: (nullable): A valid #GtkTreeIter, or %NULL
* @position: position to insert the new row, or -1 to append after existing rows
* @...: pairs of column number and value, terminated with -1
*
/**
* gtk_tree_store_insert_with_valuesv: (rename-to gtk_tree_store_insert_with_values)
* @tree_store: A #GtkTreeStore
- * @iter: (out) (allow-none): An unset #GtkTreeIter to set the new row, or %NULL.
- * @parent: (allow-none): A valid #GtkTreeIter, or %NULL
+ * @iter: (out) (optional): An unset #GtkTreeIter to set the new row, or %NULL.
+ * @parent: (nullable): A valid #GtkTreeIter, or %NULL
* @position: position to insert the new row, or -1 for last
* @columns: (array length=n_values): an array of column numbers
* @values: (array length=n_values): an array of GValues
* gtk_tree_store_prepend:
* @tree_store: A #GtkTreeStore
* @iter: (out): An unset #GtkTreeIter to set to the prepended row
- * @parent: (allow-none): A valid #GtkTreeIter, or %NULL
+ * @parent: (nullable): A valid #GtkTreeIter, or %NULL
*
* Prepends a new row to @tree_store. If @parent is non-%NULL, then it will prepend
* the new row before the first child of @parent, otherwise it will prepend a row
* gtk_tree_store_append:
* @tree_store: A #GtkTreeStore
* @iter: (out): An unset #GtkTreeIter to set to the appended row
- * @parent: (allow-none): A valid #GtkTreeIter, or %NULL
+ * @parent: (nullable): A valid #GtkTreeIter, or %NULL
*
* Appends a new row to @tree_store. If @parent is non-%NULL, then it will append the
* new row after the last child of @parent, otherwise it will append a row to
* gtk_tree_store_move_before:
* @tree_store: A #GtkTreeStore.
* @iter: A #GtkTreeIter.
- * @position: (allow-none): A #GtkTreeIter or %NULL.
+ * @position: (nullable): A #GtkTreeIter or %NULL.
*
* Moves @iter in @tree_store to the position before @position. @iter and
* @position should be in the same level. Note that this function only
* gtk_tree_store_move_after:
* @tree_store: A #GtkTreeStore.
* @iter: A #GtkTreeIter.
- * @position: (allow-none): A #GtkTreeIter.
+ * @position: (nullable): A #GtkTreeIter.
*
* Moves @iter in @tree_store to the position after @position. @iter and
* @position should be in the same level. Note that this function only
/**
* gtk_tree_view_set_model:
* @tree_view: A #GtkTreeView.
- * @model: (allow-none): The model.
+ * @model: (nullable): The model.
*
* Sets the model for a #GtkTreeView. If the @tree_view already has a model
* set, it will remove it before setting the new model. If @model is %NULL,
* gtk_tree_view_move_column_after:
* @tree_view: A #GtkTreeView
* @column: The #GtkTreeViewColumn to be moved.
- * @base_column: (allow-none): The #GtkTreeViewColumn to be moved relative to, or %NULL.
+ * @base_column: (nullable): The #GtkTreeViewColumn to be moved relative to, or %NULL.
*
* Moves @column to be after to @base_column. If @base_column is %NULL, then
* @column is placed in the first position.
/**
* gtk_tree_view_set_column_drag_function:
* @tree_view: A #GtkTreeView.
- * @func: (allow-none): A function to determine which columns are reorderable, or %NULL.
+ * @func: (nullable): A function to determine which columns are reorderable, or %NULL.
* @user_data: (closure): User data to be passed to @func, or %NULL
- * @destroy: (allow-none): Destroy notifier for @user_data, or %NULL
+ * @destroy: (nullable): Destroy notifier for @user_data, or %NULL
*
* Sets a user function for determining where a column may be dropped when
* dragged. This function is called on every column pair in turn at the
/**
* gtk_tree_view_scroll_to_cell:
* @tree_view: A #GtkTreeView.
- * @path: (allow-none): The path of the row to move to, or %NULL.
- * @column: (allow-none): The #GtkTreeViewColumn to move horizontally to, or %NULL.
+ * @path: (nullable): The path of the row to move to, or %NULL.
+ * @column: (nullable): The #GtkTreeViewColumn to move horizontally to, or %NULL.
* @use_align: whether to use alignment arguments, or %FALSE.
* @row_align: The vertical alignment of the row specified by @path.
* @col_align: The horizontal alignment of the column specified by @column.
* gtk_tree_view_set_cursor:
* @tree_view: A #GtkTreeView
* @path: A #GtkTreePath
- * @focus_column: (allow-none): A #GtkTreeViewColumn, or %NULL
+ * @focus_column: (nullable): A #GtkTreeViewColumn, or %NULL
* @start_editing: %TRUE if the specified cell should start being edited.
*
* Sets the current keyboard focus to be at @path, and selects it. This is
* gtk_tree_view_set_cursor_on_cell:
* @tree_view: A #GtkTreeView
* @path: A #GtkTreePath
- * @focus_column: (allow-none): A #GtkTreeViewColumn, or %NULL
- * @focus_cell: (allow-none): A #GtkCellRenderer, or %NULL
+ * @focus_column: (nullable): A #GtkTreeViewColumn, or %NULL
+ * @focus_cell: (nullable): A #GtkCellRenderer, or %NULL
* @start_editing: %TRUE if the specified cell should start being edited.
*
* Sets the current keyboard focus to be at @path, and selects it. This is
/**
* gtk_tree_view_get_cell_area:
* @tree_view: a #GtkTreeView
- * @path: (allow-none): a #GtkTreePath for the row, or %NULL to get only horizontal coordinates
- * @column: (allow-none): a #GtkTreeViewColumn for the column, or %NULL to get only vertical coordinates
+ * @path: (nullable): a #GtkTreePath for the row, or %NULL to get only horizontal coordinates
+ * @column: (nullable): a #GtkTreeViewColumn for the column, or %NULL to get only vertical coordinates
* @rect: (out): rectangle to fill with cell rect
*
* Fills the bounding rectangle in bin_window coordinates for the cell at the
/**
* gtk_tree_view_get_background_area:
* @tree_view: a #GtkTreeView
- * @path: (allow-none): a #GtkTreePath for the row, or %NULL to get only horizontal coordinates
- * @column: (allow-none): a #GtkTreeViewColumn for the column, or %NULL to get only vertical coordinates
+ * @path: (nullable): a #GtkTreePath for the row, or %NULL to get only horizontal coordinates
+ * @column: (nullable): a #GtkTreeViewColumn for the column, or %NULL to get only vertical coordinates
* @rect: (out): rectangle to fill with cell background rect
*
* Fills the bounding rectangle in bin_window coordinates for the cell at the
/**
* gtk_tree_view_get_visible_range:
* @tree_view: A `GtkTreeView`
- * @start_path: (out) (allow-none): Return location for start of region
- * @end_path: (out) (allow-none): Return location for end of region
+ * @start_path: (out) (optional): Return location for start of region
+ * @end_path: (out) (optional): Return location for end of region
*
* Sets @start_path and @end_path to be the first and last visible path.
* Note that there may be invisible paths in between.
/**
* gtk_tree_view_set_drag_dest_row:
* @tree_view: a #GtkTreeView
- * @path: (allow-none): The path of the row to highlight, or %NULL
+ * @path: (nullable): The path of the row to highlight, or %NULL
* @pos: Specifies whether to drop before, after or into the row
*
* Sets the row that is highlighted for feedback.
* gtk_tree_view_set_search_equal_func:
* @tree_view: A #GtkTreeView
* @search_equal_func: the compare function to use during the search
- * @search_user_data: (allow-none): user data to pass to @search_equal_func, or %NULL
- * @search_destroy: (allow-none): Destroy notifier for @search_user_data, or %NULL
+ * @search_user_data: (nullable): user data to pass to @search_equal_func, or %NULL
+ * @search_destroy: (nullable): Destroy notifier for @search_user_data, or %NULL
*
* Sets the compare function for the interactive search capabilities; note
* that somewhat like strcmp() returning 0 for equality
/**
* gtk_tree_view_set_search_entry:
* @tree_view: A #GtkTreeView
- * @entry: (allow-none): the entry the interactive search code of @tree_view should use or %NULL
+ * @entry: (nullable): the entry the interactive search code of @tree_view should use or %NULL
*
* Sets the entry which the interactive search code will use for this
* @tree_view. This is useful when you want to provide a search entry
/**
* gtk_tree_view_set_row_separator_func:
* @tree_view: a #GtkTreeView
- * @func: (allow-none): a #GtkTreeViewRowSeparatorFunc
- * @data: (allow-none): user data to pass to @func, or %NULL
- * @destroy: (allow-none): destroy notifier for @data, or %NULL
+ * @func: (nullable): a #GtkTreeViewRowSeparatorFunc
+ * @data: (nullable): user data to pass to @func, or %NULL
+ * @destroy: (nullable): destroy notifier for @data, or %NULL
*
* Sets the row separator function, which is used to determine
* whether a row should be drawn as a separator. If the row separator
* gtk_tree_view_set_tooltip_cell:
* @tree_view: a #GtkTreeView
* @tooltip: a #GtkTooltip
- * @path: (allow-none): a #GtkTreePath or %NULL
- * @column: (allow-none): a #GtkTreeViewColumn or %NULL
- * @cell: (allow-none): a #GtkCellRenderer or %NULL
+ * @path: (nullable): a #GtkTreePath or %NULL
+ * @column: (nullable): a #GtkTreeViewColumn or %NULL
+ * @cell: (nullable): a #GtkCellRenderer or %NULL
*
* Sets the tip area of @tooltip to the area @path, @column and @cell have
* in common. For example if @path is %NULL and @column is set, the tip
* gtk_tree_view_column_set_cell_data_func:
* @tree_column: A #GtkTreeViewColumn
* @cell_renderer: A #GtkCellRenderer
- * @func: (allow-none): The #GtkTreeCellDataFunc to use.
+ * @func: (nullable): The #GtkTreeCellDataFunc to use.
* @func_data: (closure): The user data for @func.
* @destroy: The destroy notification for @func_data
*
/**
* gtk_tree_view_column_set_widget:
* @tree_column: A #GtkTreeViewColumn.
- * @widget: (allow-none): A child #GtkWidget, or %NULL.
+ * @widget: (nullable): A child #GtkWidget, or %NULL.
*
* Sets the widget in the header to be @widget. If widget is %NULL, then the
* header button is set with a #GtkLabel set to the title of @tree_column.
* gtk_tree_view_column_cell_get_position:
* @tree_column: a `GtkTreeViewColumn`
* @cell_renderer: a `GtkCellRenderer`
- * @x_offset: (out) (allow-none): return location for the horizontal
+ * @x_offset: (out) (optional): return location for the horizontal
* position of @cell within @tree_column
- * @width: (out) (allow-none): return location for the width of @cell
+ * @width: (out) (optional): return location for the width of @cell
*
* Obtains the horizontal position and size of a cell in a column.
*
/**
* gtk_video_new_for_media_stream:
- * @stream: (allow-none): a `GtkMediaStream`
+ * @stream: (nullable): a `GtkMediaStream`
*
* Creates a `GtkVideo` to play back the given @stream.
*
/**
* gtk_video_new_for_file:
- * @file: (allow-none): a `GFile`
+ * @file: (nullable): a `GFile`
*
* Creates a `GtkVideo` to play back the given @file.
*
/**
* gtk_video_new_for_filename:
- * @filename: (allow-none) (type filename): filename to play back
+ * @filename: (nullable) (type filename): filename to play back
*
* Creates a `GtkVideo` to play back the given @filename.
*
/**
* gtk_video_new_for_resource:
- * @resource_path: (allow-none): resource path to play back
+ * @resource_path: (nullable): resource path to play back
*
* Creates a `GtkVideo` to play back the resource at the
* given @resource_path.
/**
* gtk_video_set_media_stream: (attributes org.gtk.Method.set_property=media-stream)
* @self: a `GtkVideo`
- * @stream: (allow-none): The media stream to play or %NULL to unset
+ * @stream: (nullable): The media stream to play or %NULL to unset
*
* Sets the media stream to be played back.
*
/**
* gtk_video_set_file: (attributes org.gtk.Method.set_property=file)
* @self: a `GtkVideo`
- * @file: (allow-none): the file to play
+ * @file: (nullable): the file to play
*
* Makes @self play the given @file.
*/
/**
* gtk_video_set_filename:
* @self: a `GtkVideo`
- * @filename: (allow-none): the filename to play
+ * @filename: (nullable): the filename to play
*
* Makes @self play the given @filename.
*
/**
* gtk_video_set_resource:
* @self: a `GtkVideo`
- * @resource_path: (allow-none): the resource to set
+ * @resource_path: (nullable): the resource to set
*
* Makes @self play the resource at the given @resource_path.
*
/**
* gtk_viewport_new:
- * @hadjustment: (allow-none): horizontal adjustment
- * @vadjustment: (allow-none): vertical adjustment
+ * @hadjustment: (nullable): horizontal adjustment
+ * @vadjustment: (nullable): vertical adjustment
*
* Creates a new `GtkViewport`.
*
/**
* gtk_viewport_set_child: (attributes org.gtk.Method.set_property=child)
* @viewport: a `GtkViewport`
- * @child: (allow-none): the child widget
+ * @child: (nullable): the child widget
*
* Sets the child widget of @viewport.
*/
* @width: New width of @widget
* @height: New height of @widget
* @baseline: New baseline of @widget, or -1
- * @transform: (transfer full) (allow-none): Transformation to be applied to @widget
+ * @transform: (transfer full) (nullable): Transformation to be applied to @widget
*
* This function is only used by `GtkWidget` subclasses, to
* assign a size, position and (optionally) baseline to their
/**
* gtk_widget_set_font_options:
* @widget: a `GtkWidget`
- * @options: (allow-none): a #cairo_font_options_t, or %NULL
+ * @options: (nullable): a #cairo_font_options_t, or %NULL
* to unset any previously set default font options
*
* Sets the `cairo_font_options_t` used for Pango rendering
/**
* gtk_widget_set_font_map:
* @widget: a `GtkWidget`
- * @font_map: (allow-none): a `PangoFontMap`, or %NULL to unset any
+ * @font_map: (nullable): a `PangoFontMap`, or %NULL to unset any
* previously set font map
*
* Sets the font map to use for Pango rendering.
/**
* gtk_widget_get_size_request:
* @widget: a `GtkWidget`
- * @width: (out) (allow-none): return location for width
- * @height: (out) (allow-none): return location for height
+ * @width: (out) (optional): return location for width
+ * @height: (out) (optional): return location for height
*
* Gets the size request that was explicitly set for the widget using
* gtk_widget_set_size_request().
* gtk_widget_insert_action_group:
* @widget: a `GtkWidget`
* @name: the prefix for actions in @group
- * @group: (allow-none): a `GActionGroup`, or %NULL to remove
+ * @group: (nullable): a `GActionGroup`, or %NULL to remove
* the previously inserted group for @name
*
* Inserts @group into @widget.
* gtk_widget_activate_action_variant: (rename-to gtk_widget_activate_action)
* @widget: a `GtkWidget`
* @name: the name of the action to activate
- * @args: (allow-none): parameters to use, or %NULL
+ * @args: (nullable): parameters to use, or %NULL
*
* Looks up the action in the action groups associated with
* @widget and its ancestors, and activates it.
/**
* gtk_widget_set_cursor: (attributes org.gtk.Method.set_property=cursor)
* @widget: a `GtkWidget`
- * @cursor: (allow-none): the new cursor
+ * @cursor: (nullable): the new cursor
*
* Sets the cursor to be shown when pointer devices point
* towards @widget.
/**
* gtk_widget_paintable_new:
- * @widget: (allow-none) (transfer none): a `GtkWidget` or %NULL
+ * @widget: (nullable) (transfer none): a `GtkWidget` or %NULL
*
* Creates a new widget paintable observing the given widget.
*
/**
* gtk_widget_paintable_set_widget: (attributes org.gtk.Method.set_property=widget)
* @self: a `GtkWidgetPaintable`
- * @widget: (allow-none): the widget to observe or %NULL
+ * @widget: (nullable): the widget to observe or %NULL
*
* Sets the widget that should be observed.
*/
/**
* gtk_window_set_default_widget: (attributes org.gtk.Property.set=default-widget)
* @window: a `GtkWindow`
- * @default_widget: (allow-none): widget to be the default, or %NULL
+ * @default_widget: (nullable): widget to be the default, or %NULL
* to unset the default widget for the toplevel
*
* Sets the default widget.
/**
* gtk_window_set_transient_for: (attributes org.gtk.Method.set_property=transient-for)
* @window: a `GtkWindow`
- * @parent: (allow-none): parent window, or %NULL
+ * @parent: (nullable): parent window, or %NULL
*
* Dialog windows should be set transient for the main application
* window they were spawned from. This allows window managers to e.g.
/**
* gtk_window_set_application: (attributes org.gtk.Method.set_property=application)
* @window: a `GtkWindow`
- * @application: (allow-none): a `GtkApplication`, or %NULL to unset
+ * @application: (nullable): a `GtkApplication`, or %NULL to unset
*
* Sets or unsets the `GtkApplication` associated with the window.
*
/**
* gtk_window_set_titlebar:
* @window: a `GtkWindow`
- * @titlebar: (allow-none): the widget to use as titlebar
+ * @titlebar: (nullable): the widget to use as titlebar
*
* Sets a custom titlebar for @window.
*
/**
* gtk_window_set_icon_name: (attributes org.gtk.Method.set_property=icon-name)
* @window: a `GtkWindow`
- * @name: (allow-none): the name of the themed icon
+ * @name: (nullable): the name of the themed icon
*
* Sets the icon for the window from a named themed icon.
*
/**
* gtk_window_get_default_size:
* @window: a `GtkWindow`
- * @width: (out) (allow-none): location to store the default width, or %NULL
- * @height: (out) (allow-none): location to store the default height, or %NULL
+ * @width: (out) (optional): location to store the default width, or %NULL
+ * @height: (out) (optional): location to store the default height, or %NULL
*
* Gets the default size of the window.
*
/**
* gtk_window_set_focus: (attributes org.gtk.Method.set_property=focus-widget)
* @window: a `GtkWindow`
- * @focus: (allow-none): widget to be the new focus widget, or %NULL to unset
+ * @focus: (nullable): widget to be the new focus widget, or %NULL to unset
* any focus widget for the toplevel window.
*
* Sets the focus widget.
/**
* gtk_window_get_group:
- * @window: (allow-none): a `GtkWindow`, or %NULL
+ * @window: (nullable): a `GtkWindow`, or %NULL
*
* Returns the group for @window.
*
/**
* gtk_window_set_child: (attributes org.gtk.Method.set_property=child)
* @window: a `GtkWindow`
- * @child: (allow-none): the child widget
+ * @child: (nullable): the child widget
*
* Sets the child widget of @window.
*/
/**
* gtk_window_handle_set_child: (attributes org.gtk.Method.set_property=child)
* @self: a `GtkWindowHandle`
- * @child: (allow-none): the child widget
+ * @child: (nullable): the child widget
*
* Sets the child widget of @self.
*/
projects / gtk4.git / commitdiff